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introduction to Programming 
an Instrument 



I ntrod UCti On This chapter introduces you to the basic concepts of bus 

communication and provides information and examples to get you 
started programming. The exact mnemonics for the commands are 
listed in chapters 5 through 9 of this manual and in the individual 
programming manuals for each module. There are three basic 
operations that can be done with a controller and this instrument via 
the bus. You can: 

1. Set up the instrument and start measurements 

2. Retrieve setup information and measurement results 

3. Send measurement data to the instrument 

Other more complicated tasks are accomplished with a combination of 
these basic functions. 

Chapter 1 deals mainly with how to set up the instrument, how to 
retrieve setup information and measurement results, and how to pass 
data to the controller. This chapter is divided into two sections. The 
first section (page 1-2) concentrates on program syntax, and the second 
section (page 1-12) discusses programming an instrument. 



||g The programming examples in this manual are written in 
Note W HP Basic 5.0 using an HP 9000 Series 200/300 Controller over HP-IB 
andRS-232C. 
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Programming 
Syntax 



Talking to the 
Instrument 



Note '4 



In general, computers acting as controllers communicate with the 
instrument by passing messages over a remote interface using the I/O 
statements provided in the instruction set of the controller's host 
language. Hence, the messages for programming the HP 16500A, 
described in this manual, will normally appear as ASCII character 
strings imbedded inside the I/O statements of your controller's 
program. 



When prograniming the HP 16500A with an HP 16501A connected, 
most of the remote operation of the HP 16501A is transparent. The 
only time a programming command is affected by the presence of an 
HP 16501A is when the number of slots is specified or returned from 
the controller. 



For example, the HP 9000 Series 200/300 BASIC and PASCAL 
language systems use the OUTPUT statement for sending program 
messages to the HP 16500A, and the ENTER statement for receiving 
response messages from the HP 16500A. 

Messages are placed on the bus using an output command and passing 
the device address, program message, and terminator. Passing the 
device address ensures that the program message is sent to the correct 
interface and instrument. 

The following command turns the command headers on: 
OUTPUT < device address > ;":SYSTEM:HEADER ON" < terminator > 

< device address > represents the address of the device being 
programmed. 
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The actual OUTPUT command you use when programming is 
dependent on the controller you are using, the programming language 
you are using, and which interface you are programming over (HP-IB 
orRS-232C). 

Angular brackets " < > in this manual, enclose words or characters 
that symbolize a program code parameter or a bus command. 

Information that is displayed in quotes represents the actual message 
that is sent across the bus. The message terminator (NL or EOI) is the 
only additional information that is also sent across the bus. 

For HP 9000 Series 200/300 controllers, it is not necessary to type in the 
actual < terminator > at the end of the program message. These 
controllers automatically terminate the program message internally 
when the return key is pressed. 



Note !ii 
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Addressing the 
Instrument for 
HP-IB 



Addressing the 
Instrument for 
RS-232C 



Since HP-IB can address multiple devices through the same interface 
card, the device address passed with the program message must 
include not only the correct interface code, but also the correct 
instrument address. 

Interface Select Code (Selects Interface). Each interface card has a 
unique interface select code. This code is used by the controller to 
direct commands and communications to the proper interface. The 
default is typically "7" for HP-IB controllers. 

Instrument Address (Selects Instrument). Each instrument on an 
HP-IB bus must have a unique instrument address between decimal 0 
and 30. The device address passed with the program message must 
include not only the correct instrument address, but also the correct 
interface select code. 

DEVICE ADDRESS = (Interface Select Code X 100) + (Instrument Address) 

For example, if the instrument address for the HP 16500A is 4 and the 
interface select code is 7, when the program message is passed, the 
routine performs its function on the instrument at device address 704. 

For the HP 16500A, the instrument address is typically set to "7" at the 
factory. This address can be changed in the HP-IB pop-up menu of the 
System Configuration menu. 

Since RS-232C can only be connected between two devices through the 
same interface card, only the correct interface code is required for the 
device address. 

Interface Select Code (Selects Interface). Each interface card has its 
own interface select code. This address is used by the controller to 
direct commands and communications to the proper interface. 
Generally, the interface select code can be any decimal value between 0 
and 31. This value can be selected through switches on the RS-232C 
interface card in the controller. 

For example, if the interface select code is 20, the device address 
required to communicate over the bus is 20. 
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Program To program the instrument over the bus, you must have an 
Message Syntax understanding of the command format and structure expected by the 
instrument. The instrument is remotely programmed with program 
messages. These are composed of sequences of program message 
units, with each unit representing a program command or query. A 
program command or query is composed of a sequence of functional 
elements that include separators, headers, program data, and 
terminators. These are sent to the instrument over the system interface 
as a sequence of ASCII data messages. For example: 

PROGRAM MESSAGE UNIT 
, 1 , 

OUTPUT XXX ; " : SYSTEM : HEADER ON" 

OUTPUT COMMAND ' 

DEVICE ADDRESS ' 

(OPTIONAL FOR HP 16500A) ' 

PROGRAM MNEMONICS ' ' 

SEPARATOR ' 

DATA 

16SM/SL1* 



Separator The < separator > shown in the program message refers to a blank 
space which is required to separate the program mnemonic from the 
program data. 

Command Syntax A command is composed of a header, any associated data, and a 

terminator. The header is the mnemonic or mnemonics that represent 
the operation to be performed by the instrument. The different types 
of headers are discussed in the following paragraphs. 

Simple Command Header. Simple command headers contain a single 
mnemonic. START and STOP are examples of simple command 
headers typically used in this instrument. The syntax is: 

< program mnemonio < terminator > 
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When program data must be included with the simple command 
header (for example, :SELECT 1), a separator is added. The syntax is: 

< program mnemonio < separator > < program data> < terminator > 

Compound Command Header. Compound command headers are a 
combination of two or more program mnemonics. The first mnemonic 
selects the subsystem, and the last mnemonic selects the function within 
that subsystem. Additional mnemonics appear between the subsystem 
mnemonic and the function mnemonic when there are additional levels 
within the subsystem that must be transversed. The mnemonics within 
the compound message are separated by colons. For example: 

To execute a single function within a subsystem, use the following: 

: < subsystem > : < function > < separator > < program data > < terminator > 

(For example :SYSTEM:LONGFORM ON) 

To transverse down a level of a subsystem to execute a subsystem 
within that subsystem: 

: < subsystem > : < subsystem > : < function > < separator > < program data > 

< terminator > 

(For example :MMEMORY:LOAD:CONFIG "FILE_") 

To execute more than one function within the same subsystem a 
semi-colon is used to separate the functions: 

: < subsystem > : < function > < separator > < data > ; < function > < separator > 
<data> < terminator > 

(For example :SYSTEM:LONGFORM ON;HEADER ON) 
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Identical function mnemonics can be used for more than one 
subsystem. For example, in the oscilloscope module the function 
mnemonic RANGE may be used to change the vertical range or to 
change the horizontal range: 

:CHANNEL1:RANGE .4 

- sets the vertical range of channel 1 to 0.4 volts full scale. 
:TIMEBASE: RANGE 1 

- sets the horizontal timebase to 1 second full scale. 

CHANNEL1 and TIMEBASE are subsystem selectors and determine 
which range is being modified. 

Common Command Header. Common command headers control 
IEEE 488.2 functions within the instrument (such as clear status, etc.). 
Their syntax is: 

*< command header > < terminator > 

No space or separator is allowed between the asterisk and the 
command header. *CLS is an example of a common command header. 
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Query Command 




Command headers immediately followed by a question mark (?) are 
queries. After receiving a query, the instrument interrogates the 
requested function and places the answer in its output queue. The 
output message remains in the queue until it is read or another 
command is issued. When read, the message is transmitted across the 
bus to the designated listener (typically a controller). The logic 
analyzer query :MACHINEl:TWAVEFORM:RANGE? places the 
current seconds per division full scale range for machine 1 in the 
output queue. The controller input statement: 

ENTER < device address > ;Range 

passes the value across the bus to the controller and places it in the 
variable Range. 

Query commands are used to find out how the instrument is currently 
configured. They are also used to get results of measurements made by 
the instrument, with the query actually activating the measurement. 
For example, the oscilloscope command :MEASURE:RISETIME? 
instructs the instrument to measure the risetime of your waveform and 
place the result in the output queue. 



The output queue must be read before the next program message is 
sent. For example, when you send the oscilloscope query 
:MEASURE:RISETTME? you must follow that query with the 
program statement ENTER Value risetime to read the result of the 
query and place the result in a variable (Value_risetime). 

Sending another command before reading the result of the query will 
cause the output buffer to be cleared and the current response to be 
lost. This will also generate an error in the error queue. 
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Program Head6r Program headers can be sent using any combination of uppercase or 
Options lowercase ASCII characters. Instrument responses, however, are 
always returned in uppercase. 

Both program command and query headers may be sent in either 
longform (complete spelling), shortform (abbreviated spelling), or any 
combination of longform and shortform. Either of the following 
examples turn the headers and longform on. 

:SYSTEM:HEADER 0N;L0NGF0RM ON - longform 

:SYST:HEAD ON;LONG ON - shortform 

Programs written in longform are easily read and are almost 
self-documenting. The shortform syntax conserves the amount of 
controller memory needed for program storage and reduces the 
amount of I/O activity. 



jjgl The rules for shortform syntax are shown in the chapter Trograrnrm'ng 
Note w and Documentation Conventions." 



Program Data Program data is used to convey a variety of types of parameter 

information related to the command header. At least one space must 
separate the command header or query header from the program data. 

< program mnemonio < separator > <data> < terminator > 

When a program mnemonic or query has multiple data parameters a 
comma separates sequential program data. 

< program mnemonio < separator > < data >,< data > < terminator > 
For example, :MENU 0,2 has two data parameters: 0 and 2. 
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Character Program Data. Character program data is used to convey 
parameter information as short alpha or alphanumeric strings. For 
example, the run mode command RMODE can be set to single or 
repetitive. The character program data in this case may be SINGLE or 
REPETITIVE. :RMODE SINGLE sets the run mode to single. 

Numeric Program Data. Some command headers require program 
data to be a number. For example, :MENU requires the desired menu 
selection to be expressed numerically. The instrument recognizes 
integers, real numbers, and scientific notation. With the proper prefix, 
the instrument will also recognize binary, octal, and hexadecimal base 
numbers. If no prefix is added, the default is decimal. 



Table 1-1. Numeric Data Prefixes 



Base 


Prefix 


Example 


Binary 


#B 


#B101010 


Octal 


#Q 


#01234567 


Hexadecimal 


#H 


#H123...ABCDEF 


Decimal 


none 


1234567890 



Program The program codes within a data message are executed after the 
Message program message terminator is received. The terminator may be either 
Terminator 311 (New Line) character, an EOI (End-Or-Identify) asserted, or a 
combination of the two. All three ways are equivalent with the exact 
encodings for the program terminators listed in the appendix "Message 
Communication and System Functions." Asserting the EOI sets the 
EOI control line low on the last byte of the data message. The NL 
character is an ASCII linefeed (decimal 10). 



Note 



The NL (New Line) terminator has the same function as an EOS (End 
Of String) and EOT (End Of Text) terminator. 

The EOI terminator only applies to HP-IB. 
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Selecting Multiple You can send multiple program commands and program queries for 
S U bsystems different subsystems on the same line by separating each command 
with a semicolon. The colon following the semicolon enables you to 
enter a new subsystem. For example: 

< program mnemonio < data >;:< program mnemonio <data> < terminator > 
:MMEMORY:CATALOG?;:SYSTEM: PRINT ALL 

||3& Multiple commands may be any combination of compound and simple 
Note ^tr commands. 



Summary The following illustration summarizes the syntax for programming over 
the bus. 

PROGRAM MESSAGE UNIT 
| 

/ v 

OUTPUT yyy. ii .qvcTru.uc'AnrD am" 

OUTPUT COMMAND ' 

DEVICE ADDRESS ' 

(OPTIONAL FOR HP 16500A) ' 

PROGRAM MNEMONICS ' ' 

SEPARATOR — 1 

DATA 
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Programming 
an Instrument 

Initialization To make sure the bus and all appropriate interfaces are in a known 
state, begin every program with an initialization statement. For 
example: 

CLEAR XXX ! initializes the interface of the instrument. 

Then load a predefined configuration file from the disc to preset the 
instrument to a known state. For example: 

OUTPUT XXX/:MMEMORY:LOAD:CONRG 'DEFAULT " 

would load the configuration file "DEFATJLT_" into all of the 
modules and mainframe. Refer to the chapter "Mmemory Subsystem" 
for more information on the LOAD command. 



The three Xs (XXX) after the "CLEAR" and "OUTPUT" statements in 
Note W the previous examples refer to the device address required for 

programming over either HP-IB or RS-232C. The commands and 
syntax for initializing the instrument are discussed in the chapter 
"Common Commands." 



Refer to your controller manual and programming language reference 
manual for information on initializing the interface. 
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Selecting a Before you can program a module in the HP 16500A or the HP 16501A 
Module over the bus, you must first select the appropriate module. To select 
the module, use the mainframe command :SELECT followed by the 
numeric reference for the slot location of the master card for that 
module. For an HP 16500A alone, 1...5 refers to slot A...E respectively. 
When an HP 16501A is connected, 1...10 refer to slot A.. J. SELECT 
1 selects the module in slot A, :SELECT 2 selects the module in slot B, 
etc. 



: SELECT 



Only available when an 
HP 16501A is connected. 



0 (SELECTS SYSTEM/INTERMODULE) 

1 (SELECTS MODULE IN SLOT A) 

2 (SELECTS MODULE IN SLOT 8) 



•3 (5tLtCI5 MODULE IN SLOT C) 

•4 (SELECTS MODULE IN SLOT D) 

■5 (SELECTS MODULE IN SLOT E) 

- 6 — - '.SELECTS MODULE I N 3LQ T f- ) 

•7 (SELECTS MODULE IN SLOT G) 

•8 (SELECTS MODULE IN SLOT H) 

•9 — (SELECTS MODULE IN SLOT I) 

• 10- (SELECTS MODULE IN SLOT J) 

-1 (SELECTS OPTION 1) 

-2 (SELECTS OPTION 2) 

1650064? 



Figure 1-1. Select Command Tree 
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For example, if the TIMEBASE card for your oscilloscope module is in 
slot B, then the command: 

:SELECT2 

would select the oscilloscope module. Figure 1-1 shows the command 
tree for the select command. For more information on the select 
command, refer to the chapter "Mainframe Commands." 



iJSj Commands may be sent over the bus for any module while in any menu 
Note W as long as the appropriate module has been selected. 



Example Program This program demonstrates the basic command structure used to 

program a module of the HP 16500A. 



10 CLEAR XXX 

20 OUTPUT XXX;":SYSTEM:HEADER ON" 

30 OUTPUT XXX;":SYSTEM:LONGFORM ON" 

40 DIM Card$[100] 

50 OUTPUT XXX;":CARDCAGE?" 

60 ENTER XXX; Card $ 

70 PRINT Card$ 

80 OUTPUT XXX;":MMEM:LOAD:CONFIG TEST 

90 OUTPUT XXX;":SELECT 5" 
100 OUTPUT XXX;':MENU 5,3" 
1 10 OUTPUT XX*":RMODE SINGLE" 
120 OUTPUT XXX;': START" 



{Initialize instrument interface 
(Turn headers on 
ITurn longform on 
[Reserve memory for string variable 
{Verify which modules are loaded 
{Enter result in a string variable 
{Print result of query 
E',5" ! Load configuration file 
{into module in slot E 
(Select module in slot E 
(Select menu for module in slot E 
(Select run mode 
(Run the measurement 



l|g& The three Xs (XXX) after the "OUTPUT and "ENTER" statements in 
Note "w the previous examples refer to the device address required for 
progr amming over either HP-IB or RS-232C. 
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Program OVGrvieW Line 10 initializes the instrument interface to a known state, and lines 

20 and 30 turn the headers and longform on. 

Line 50 queries the cardcage to confirm which modules are loaded in 
this mainframe. Then line 70 prints the result of the query on screen. 
In this example the query returns: 

:CARDCAGE -1 ,-1 ,12,1 1 ,31 ,0,0,4,4,5 

The first five numbers returned are the card identification numbers. 
The last five numbers list the module assignment for each card. In this 
example, the response shows that there is an oscilloscope acquisition 
card in slot C which is assigned to the oscilloscope timebase card in slot 
D. Also, there is a logic analyzer card in slot E which is assigned to 
itself. Refer to the chapter "Mainframe Commands" for more 
information on CARDCAGE command. 

Line 80 loads the configuration file TEST E" into the module in slot E 
and line 90 selects the module in slot E. Then line 100 displays one of 
menus of the module in slot E. 

Lines 110 and 120 tell the analyzer to run the measurement configured 
by the file "TEST_E" one time. 
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Receiving 
Information from 
the Instrument 



Note Qp 



After receiving a query (command header followed by a question 
mark), the instrument interrogates the requested function and places 
the answer in its output queue. The answer remains in the output 
queue until it is read or another command is issued. When read, the 
message is transmitted across the bus to the designated listener 
(typically a controller). The input statement for receiving a response 
message from an instrument's output queue typically has two 
parametersjthe device address and a format specification for handling 
the response message. For example, to read the result of the query 
command :S YSTEM:LONGFORM? you would execute the statement: 

ENTER < device address > ;Setting 

where < device address > represents the address of your device. This 
would enter the current setting for the longform command in the 
numeric variable Setting. 



All results for queries sent in a program message must be read before 
another program message is sent. For example, when you send the 
query :SELECT?, you must follow that query with the program 
statement ENTER Setting to read the result of the query and place the 
result in a variable (Setting). 

Sending another command before reading the result of the query will 
cause the output buffer to be cleared and the current response to be 
lost. This will also cause an error to be placed in the error queue. 

The actual ENTER program statement you use when programming is 
dependent on the programming language you are using. 



The format specification for handling the response messages is 
dependent on both the controller and the programming language. 
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Response Hesder The format of the returned ASCII string depends on the current 

Options settings of the SYSTEM HEADER and LONGFORM commands. 
The general format is: 

< header > < separator > <data> < terminator > 

The header identifies the data that follows and is controlled by issuing 
a :SYSTEM:HEADER ON/OFF command. If the state of the header 
command is OFF, only the data is returned by the query. The format 
of the header is controlled by the :S YSTEM:LONGFORM ON/OFF 
command. If longform is OFF , the header will be in its shortform and 
the header will vary in length depending on the particular query. The 
following would be returned from a :SELECT? command query: 

<data> < terminator > (with HEADER OFF) 

:SEL< separator > <data> < terminator > (with HEADER ON/LONGFORM OFF) 

:SELECT< separator > <data> <terminator> (with HEADER ON/LONGFORM 
ON) 



ijgj A command or query may be sent in either longform or shortform, or 
Note W in any combination of longform and shortform. The HEADER and 

LONGFORM commands only control the format of the returned data 
and have no effect on the way commands are sent. Common 
commands never return a header. 



Refer to chapter 1, "System Subsystem" for information on turning the 
HEADER and LONGFORM commands on and off. 
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Response Data 
Formats 



Note IS? 



Numeric Base 



Most data will be returned as exponential or integer numbers. 
However, query data of instrument setups may be returned as 
character data. Interrogating the run mode :RMODE? will return one 
of the following: 

:RMODE REPETITIVE < terminator > (with HEADER ON/LONGFORM ON) 
:RMOD REP<terminator> (with HEADER ON/LONGFORM OFF) 
REPETmVE<terminator> (with HEADER OFF/LONGFORM ON) 
REP < terminator > (with HEADER OFF/LONGFORM OFF) 



Refer to the individual commands in this manual and in the individual 
programming manuals for each module for information on the format 
(alpha or numeric) of the data returned from each query. 



Most numeric data will be returned in the same base as shown on 
screen. When the prefix #B precedes the returned data, the value is in 
the binary base. Likewise, #Q is the octal base and #H is the 
hexadecimal base. If no prefix precedes the returned numeric data, 
then the value is in the decimal base. 
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String Variables If you want to observe the headers for queries, you must bring the 
returned data into a string variable. Reading queries into string 
variables is simple and straightforward, requiring little attention to 
formatting. For example: 

ENTER < device address > ; Results 

places the output of the query in the string variable Result$. 



lla String variables are case sensitive and must be expressed exactly the 
Note 4IP same each time they are used. 



The output of the instrument may be numeric or character data 
depending on what is queried. Refer to the specific commands for the 
formats and types of data returned from queries. 



gjg| For the example programs, the device being programmed is at device 
N Ote ^Sr address XXX. The actual address will vary according to how you have 
configured the bus for your own application and whether you are 
programming over HP-IB or RS-232C. 



The following example shows logic analyzer data being returned to a 
string variable with headers off: 

10 OUTPUT XXX;": SYSTEM: HEADER OFP 
20 DIM Rang$[30] 

30 OUTPUT XXX;":MACHINE1 :TWAVEFORM: RANGE?" 
40 ENTER XXX; Rang$ 
50 PRINT Rang$ 
60 END 

After running this program, the controller displays: 
+ 1.00000E-05 
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Numeric Variables 



Definite-Length 
Block Response 
Data 




If you do not need to see the headers when a numeric value is returned 
from the instrument, then you can use a numeric variable. When you 
are receiving numeric data into a numeric variable, turn the headers 
off. Otherwise the headers may cause misinterpretation of returned 
data. 

The following example shows logic analyzer data being returned to a 
numeric variable. 

10 OUTPUT XXX; ": SYSTEM: HEADER OFF 

20 OUTPUT XXX;":MACHINE1:TWAVEF0RM:RANGE?" 

30 ENTER XXX; Rang 

40 PRINT Rang 

50 END 

After running this program, the controller displays: 



Definite-length block response data allows any type of 
device-dependent data to be transmitted over the system interface as a 
series of 8-bit binary data bytes. This is particularly useful for sending 
large quantities of data or 8-bit extended ASCII codes. The syntax is a 
pound sign ( # ) followed by a non-zero digit representing the number 
of digits in the decimal integer. After the non-zero digit is the decimal 
integer that states the number of 8-bit data bytes being sent. This is 
followed by the actual data. 

NUMBER OF DIGITS 
THAT FOLLOW 



#800000080<e i ghty bytes of dotoXtermi nator> 
NUMBER OF BYTES 

TO BE TRANSMITTED issm/blzz 

For example, for transmitting 80 bytes of data, the syntax would be: 

The "8" states the number of digits that follow, and "00000080" states 
the number of bytes to be transmitted. 

Indefinite-length block data is not supported on the HP16500A. 
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Multiple Queries You can send multiple queries to the instrument within a single 

program message, but you must also read them back within a single 
program message. This can be accomplished by either reading them 
back into a string variable or into multiple numeric variables. For 
example, you could read the result of the query 
:SYSTEM:HEADER?;LONGFORM? into the string variable 
ResultsS with the command: 

ENTER XXX; Results$ 

When you read the result of multiple queries into string variables, each 
response is separated by a semicolon. For example, the response of the 
query :S YSTEMiHEADER? :LONGFORM? with HEADER and 
LONGFORM on would be: 

: SYSTEM: HEADER 1;:SYSTEM:LONGFORM 1 

If you do not need to see the headers when the numeric values are 
returned, then you could use following program message to read the 
query :SYSTEM:HEADERS?;LONGFORM? into multiple numeric 
variables: 



ENTER XXX; Result 1 ,Result2 



i|S When you are receiving numeric data into numeric variables, the 
Note %lr headers should be turned off, Otherwise the headers may cause 
misinterpretation of returned data. 



Instrument StatUS Status registers track the current status of the instrument. By checking 

the instrument status, you can find out whether an operation has been 
completed, whether the instrument is receiving triggers, and more. The 
appendix "Status Reporting" explains how to check the status of the 
instrument. 
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2 



Introduction This chapter describes the interface functions and some general 

concepts of the HP-IB. In general, these functions are defined by 
IEEE 488.1 (HP-IB bus standard). They deal with general bus 
management issues, as well as messages which can be sent over the bus 
as bus commands. 

The HP-IB information in this chapter is not affected when an 

HP 16501A is connected to the HP 16500A. Therefore, all references 

to the HP 16500A apply whether or not an HP 16501A is connected. 



The interface capabilities of the HP 16500A, as defined by IEEE 488.1 
are SHI, AH1, T5, TEO, L3, LEO, SRI, RL1, PP1, DC1, DTI, CO, and 
E2. For more information, refer to table 6-1 in the chapter "Mainframe 
Commands." 



The HP-IB has two modes of operation: command mode and data 
mode. The bus is in command mode when the ATN line is true. The 
command mode is used to send talk and listen addresses and various 
bus commands, such as a group execute trigger (GET). The bus is in 
the data mode when the ATN line is false. The data mode is used to 
convey device-dependent messages across the bus. These 
device-dependent messages include all of the instrument commands 
and responses found in chapters 5 through 9 of this manual and in the 
individual programming manuals for each module. 



Interface 
Capabilities 



Command and 
Data Concepts 
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Add reSSing By using the front-panel touchscreen, the HP-IB interface can be 

placed in either talk only mode (Printer) or addressed talk/listen mode 
(Controller) (see the HP 1650QAI16S01A Reference Manual). Talk only 
mode should be used when you want the instrument to talk directly to a 
printer without the aid of a controller. Addressed talk/listen mode is 
used when the instrument will operate in conjunction with a controller. 
When the instrument is in the addressed talk/listen mode, the following 
is true: 

• Each device on the HP-IB resides at a particular address ranging 
from 0 to 30. 

• The active controller specifies which devices will talk, and which 
will listen. 

• An instrument, therefore, may be talk addressed, listen 
addressed, or unaddressed by the controller. 

If the controller addresses the instrument to talk, it will remain 
configured to talk until it receives an interface clear message (IFC), 
another instrument's talk address (OTA), its own listen address 
(MLA), or a universal untalk command (UNT). 

If the controller addresses the instrument to listen, it will remain 
configured to listen until it receives an interface clear message (IFC) its 
own talk address (MTA), or a universal unlisten command (UNL). 
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Communicating 
Over the HP-iB 
Bus (HP 9000 
Series 200/300 
Controller) 



Since HP-IB can address multiple devices through the same interface 
card, the device address passed with the program message must 
include not only the correct instrument address, but also the correct 
interface code. 

Interface Select Code (Selects Interface). Each interface card has its 
own interface select code. This code is used by the controller to direct 
commands and communications to the proper interface. The default is 
typically V for HP-IB controllers. 

Instrument Address (Selects Instrument). Each instrument on the 
HP-IB port must have a unique instrument address between decimal 0 
and 30. The device address passed with the program message must 
include not only the correct instrument address, but also the correct 
interface select code. 

DEVICE ADDRESS = (Interface Select Code X 100) + (Instrument Address) 

For example, if the instrument address for the HP 16500A is 4 and the 
interface select code is 7, when the program message is passed, the 
routine performs its function on the instrument at device address 704. 
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Local, Remote, 
and Local 
Lockout 



Note 



jISp 



The local, remote, and remote with local lockout modes may be used 
for various degrees of front-panel control while a program is running. 
The instrument will accept and execute bus commands while in local 
mode, and the front panel will also be entirely active. If the HP 16500A 
is in remote mode, the instrument will go from remote to local with any 
touchscreen or mouse activity. In remote with local lockout mode, all 
controls (except the power switch) are entirely locked out. Local 
control can only be restored by the controller. 

Cycling the power will also restore local control, but this will also reset 
certain HP-IB states. 



The instrument is placed in remote mode by setting the REN (Remote 
Enable) bus control line true, and then addressing the instrument to 
listen. The instrument can be placed in local lockout mode by sending 
the local lockout command (LLO). The instrument can be returned to 
local mode by either setting the REN line false, or sending the 
instrument the go to local command (GTL). 
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BUS Commands The following commands are IEEE 488.1 bus commands (ATN true). 

IEEE 488.2 defines many of the actions which are taken when these 
commands are received by an instrument. 

Device Clear The device clear (DCL) or selected device clear (SDC) commands 

clear the input and output buffers, reset the parser, clear any pending 
commands, and clear the Request-OPC flag. 

Group Execute The group execute trigger command will cause the same action as the 
Trigger (GET) START command for Group Run: the instrument will acquire data for 
the active waveform and listing display (s) . 

Interface Clear This command halts all bus activity. This includes unaddressing all 
(IFC) listeners and the talker, disabling serial poll on all devices, and 
returning control to the system controller. 
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I nt rod U Cti O n This chapter describes the interface functions and some general 

concepts of the RS-232C. The RS-232C information in this chapter is 
not affected when an HP 16501A is connected to the HP 16500A. 
Therefore, all references to the HP 16500A apply whether or not an 
HP 16501A is connected. 

The RS-232C interface on this instrument is Hewlett-Packard's 
implementation of EIA Recommended Standard RS-232C, "Interface 
Between Data Terminal Equipment and Data Communications 
Equipment Employing Serial Binary Data Interchange." With this 
interface, data is sent one bit at a time and characters are not 
synchronized with proceeding or subsequent data characters. Each 
character is sent as a complete entity without relationship to other 
events. 



IEEE 488.2 is designed to work with IEEE 488.1 as the physical 
interface. When RS-232C is used as the physical interface, as much of 
IEEE 488.2 is retained as the hardware differences will allow. No 
IEEE 488.1 messages such as DCL, GET, and END are available. 



Note 
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Interface 
Operation 



The HP 16500A can be programmed with a controller over RS-232C 
using either a minimum three-wire or extended hardwire interface. 
The operation and exact connections for these interfaces are described 
in more detail in the following sections. 

When you are programming an HP 16500A over RS-232C with a 
controller, you are normally operating directly between two DTE 
(Data Terminal Equipment) devices as compared to operating 
between a DTE device and a DCE (Data Communications 
Equipment) device. 

When operating directly between two RS-232C devices, certain 
considerations must be taken into account. For three-wire operation, 
XON/XOFF must be used to handle protocol between the devices. 
For extended hardwire operation, protocol may be handled either with 
XON/XOFF or by manipulating the CTS and RTS lines of the HP 
16500A. For both three-wire and extended hardwire operation, the 
DCD and DSR inputs to the HP 16500A must remain high for proper 
operation. 

With extended hardwire operation, a high on the CTS input allows the 
HP 16500A to send data and a low on this line disables the HP 16500A 
data transmission. Likewise, a high on the RTS line allows the 
controller to send data and a low on this line signals a request for the 
controller to disable data transmission. 

Since three-wire operation has no control over the CTS input, internal 
pull-up resistors in the HP 16500A assure that this line remains high for 
proper three-wire operation. 



Cables Selecting a cable for the RS-232C interface is dependent on your 

specific application. The following paragraphs describe which lines of 
the HP 16500A are used to control the operation of the RS-232C bus 
relative to the HP 16500A. To locate the proper cable for your 
application, refer to the reference manual for your controller. This 
manual should address the exact method your controller uses to 
operate over the RS-232C bus. 
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Minimum 
Three-Wire 
Interface with 
Software 
Protocol 



With a three-wire interface, the software (as compared to interface 
hardware) controls the data flow between the HP 16500A and the 
controller. This provides a much simpler connection between devices 
since you can ignore hardware handshake requirements. The HP 
16500A uses the following connections on its RS-232C interface for 
three-wire communication: 

• Pin 7 SGND (Signal Ground) 

• Pin 2 TD (Transmit Data from HP 16500A) 

• Pin 3 RD (Receive Data into HP 16500A) 



The TD (Transmit Data) line from the HP 16500A must connect to the 
RD (Receive Data) line on the controller. Likewise, the RD line from 
the HP 16500A must connect to the TD line on the controller. Internal 
pull-up resistors in the HP 16500A assure the DCD, DSR, and CIS 
lines remain high when you are using a three-wire interface. 



lia The three-wire interface provides no hardware means to control data 
Note W flow between the controller and the HP 16500A. XON/OFF protocol 
is the only means to control this data flow. 
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Extended 
Interface with 
Hardware 
Handshake 



With the extended interface, both the software and the hardware can 
control the data flow between the HP 16500A and the controller. This 
allows you to have more control of data flow between devices. The HP 
16500A uses the following connections on its RS-232C interface for 
extended interface communication: 

• Pin 7 SGND (Signal Ground) 

• Pin 2 TD (Transmit Data from HP 16500A) 

• Pin 3 RD (Receive Data into HP 16500A) 

The additional lines you use depends on your controller's 
implementation of the extended hardwire interface. 

• Pin 4 RTS (Request To Send) is an output from the 

HP 16500A which can be used to control incoming data flow. 

• Pin 5 CTS (Clear To Send) is an input to the HP 16500A which 
controls data flow from the HP 16500A. 

• Pin 6 DSR (Data Set Ready) is an input to the HP 16500A 
which controls data flow from the HP 16500A within two bytes. 

• Pin 8 DCD (Data Carrier Detect) is an input to the 

HP 16500A which controls data flow from the HP 16500A within 
two bytes. 

• Pin 20 DTR (Data Terminal Ready) is an output from the 

HP 16500A which is enabled as long as the HP 16500A is turned 
on. 

The TD (Transmit Data) line from the HP 16500A must connect to the 
RD (Receive Data) line on the controller. Likewise, the RD line from 
the HP 16500A must connect to the TD line on the controller. 

The RTS (Request To Send), is an output from the HP 16500A which 
can be used to control incoming data flow. A high on the RTS line 
allows the controller to send data and a low on this line signals a 
request for the controller to disable data transmission. 
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The CTS (Clear To Send), DSR (Data Set Ready), and DCD (Data 
Carrier Detect) lines are inputs to the HP 16500A which control data 
flow from the HP 16500A (Pin 2). Internal pull-up resistors in the HP 
16500A assure the DCD and DSR lines remain high when they are not 
connected. 

When DCD or DSR are connected to the controller, the controller 
must keep these lines and the CTS line high to enable the HP 16500A 
to send data to the controller. A low on any one of these lines will 
disable the HP 16500A data transmission. Dropping the CTS line low 
during data transmission will stop HP 16500A data transmission 
immediately. Dropping either the DSR or DCD line low during data 
transmission will stop HP 16500A data transmission, but as many as 
two additional bytes may be transmitted from the HP 16500A. 



Cable Example Figure 3-1 is an example of how to connect the HP 16500A to the 

HP 98628 Interface card of an HP 9000 series 200/300 controller. For 
more information on cabling, refer to the reference manual for your 
specific controller. 



||g& Since this example does not have the correct connections for hardware 
Note "W handshake, XON/XOFF protocol must be used when connecting the 
HP 16500A as shown in figure 3-1 



HP 16500A 
REAR PANEL 



HP 98628 
INTERFACE CARD 



13242N 
(MALE-TO-MALE) 



5061-4216 
DCE OPT. 002 
( FEMALE-TO-FEMALE > 



Figure 3-1. Cable Example 
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By using the front-panel touchscreen, the RS-232C interface can be 
placed in either the printer mode or the controller mode. The printer 
mode should be used when you want the instrument to talk directly to a 
printer over RS-232C without the aid of a controller. The controller 
mode is used when the instrument will operate in conjunction with a 
controller over RS-232C. 

If you are not familiar with how to configure the RS-232C interface, 
refer to the HP 1650QA/16501A Reference Manual. 



The baud rate, stop bits, parity, protocol, and data bits must be 
configured exactly the same for both the controller and the HP 16500A 
to properly communicate over the RS-232C bus. The HP 16500A 
RS-232C interface capabilities are listed below: 

• Baud Rate: 110, 300, 600, 1200, 2400, 4800, 9600, or 192 k 

• Stop Bits: 1, 1.5, or 2 

• Parity: None, Odd, or Even 

• Protocol: None or XON/XOFF 

• Data Bits: 8 

PrOtOCOl NONE. With a three-wire interface, selecting NONE for the protocol 
does not allow the sending or receiving device to control data flow. No 
control over the data flow increases the possibility of missing data or 
transferring incomplete data. 

With an extended hardwire interface, selecting NONE allows a 
hardware handshake to occur. With hardware handshake, hardware 
signals control data flow. 



Configuring the 
Interface 



Interface 
Capabilities 
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XON/XOFF. XON/XOFF stands for Transmit On/Transmit Off. With 
this mode the receiver (controller or HP 16500A) controls data flow 
and can request that the sender (HP 16500A or controller) stop data 
flow. By sending XOFF (ASCII 17) over its transmit data line, the 
receiver requests that the sender disables data transmission. A 
subsequent XON (ASCII 19) allows the sending device to resume data 
transmission. 

A controller sending data to the HP 16500A should send no more than 
32 bytes of data after an XOFF. 

The HP 16500A will not send any data after an XOFF is received until 
an XON is received. 

Data Bits Data bits are the number of bits sent and received per character that 
represent the binary code of that character. The HP 16500A supports 
the 8-bit binary code. 



iggjL The controller must be in the 8-bit mode to properly communicate over 
Note W theRS-232C. 



For more information on the RS-232C interface, refer to the HP 
16500A Reference Manual. For information on RS-232C voltage levels 

and connector pinouts, refer to the HP 1650QA/16501A Service Manual, 
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Communicating 
Over the 
RS-232C Bus 
(HP 9000 
Series 200/300 
Controller) 



Each RS-232C interface card has its own interface select code. This 
code is used by the controller to direct commands and communications 
to the proper interface. Unlike HP-IB, which allows multiple devices 
to be connected through a single interface card, RS-232C is only 
connected between two devices at a time through the same interface 
card. Because of this, only the interface code is required for the device 
address. 

Generally, the interface select code can be any decimal value between 0 
and 31, except for those interface codes which are reserved by the 
controller for internal peripherals and other internal interfaces. This 
value can be selected through switches on the interface card. For more 
information, refer to the reference manual for your interface card or 
controller. 

For example, if your RS-232C interface select code is 20, the device 
address required to communicate over the RS-232C bus is 20. 



Lockout To lockout the front panel controls use the system command 

Command LOCKOUT. When this function is on, all controls (except the power 

switch) are entirely locked out. Local control can only be restored by 
sending the command :LOCKOUT OFF. For more information on 
this command see the chapter "Mainframe Commands" in this manual. 



Cycling the power will also restore local control, but this will also reset 
certain RS-232C states. 



Note 
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Programming and Documentation 
Conventions 



Introduction This chapter covers the programming conventions used in 

programming the instrument, as well as the documentations 
conventions used in this manual. This chapter also contains a detailed 
description of the command tree and command tree traversal. 



Truncation RulG The truncation rule for the mnemonics used in headers and alpha 

arguments is: 

• The mnemonic is the first four characters of the keyword unless 
the fourth character is a vowel, then the mnemonic is the first 
three characters of the keyword. 

This rule will not be used if the length of the keyword is exactly four 
characters. When the keyword only contains four characters, there is 
no shortform of the command. 

Some examples of how the truncation rule is applied to various 
commands are shown in table 4-1. 
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Table 4-1. Mnemonic Truncation 



Longform 


Shortform 


START 


STAR 


CARDCAGE 


CARD 


MENU 


MENU 


SELECT 


SEL 


PATTERN 


PATT 



The Command 
Tree 



The command tree (figure 4-1) shows all commands in the HP 16500A 
mainframe and the relationship of the commands to each other. You 
should notice that the common commands are not actually included 
with the command tree. After a < NL > (linefeed - ASCII decimal 
10) has been sent to the instrument, the parser will be set to the "root" 
of the command tree. 



Command Types 



The commands for this instrument can be placed into three types. The 
three types are: 

Common Commands. Common commands are independent of the 
tree, and do not affect the position of the parser within the tree. 



Example: "*CLS" 



Mainframe Commands. The mainframe commands reside at the root 
of the command tree. These commands are always par sable if they 
occur at the beginning of a program message, or are preceded by a 
colon. 



Example: ^select v 



Subsystem Commands. Subsystem commands are grouped together 
under a common node of the tree, such as the MMEMORY commands. 
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SELect 0 



Conmon 
Commands 



«CLS 
»ESE 
*ESR 
*IDN 
*IST 
*OPC 
*OPT 
•PRE 
*RST 
»SRE 
•STB 
»TRG 
*TST 
*WAI 



SYSTem 



BEEPer 


DATA 


CAPabi 1 ity 


DSP 


CARDcage 


ERRor 


CESE 


HEADer 


CESR 


LONG form 


EOI 


PRINt 


LER 


SETup 


LOCKout 




MENU 




MESE<N> 




MESR<N> 




RMODe 




SELect 




SETColor 




STARt 




STOP 





MMEMory 



AUTolood 

CATa I og 

COPY 

DOWN load 

INITial ize 

LOADC :CONf ig] 

LOAD:IASSembler 

MSI 

PACK 

PURge 

STOReL :CONf ig] 
UPLoad 



INTermodu le 



DELete 

HTIMe 

INPort 

INSert 

SKEW<N> 

TREE 

TTIMe 



Figure 4-1. The HP 16500A Mainframe Command Tree 
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TrGG TraVGrsal Command headers are created by traversing down the command tree. 

Rules A legal command header from the command tree in figure 4-1 would 
be ":MMEM:INITIALIZE." This is referred to as a compound header. 
A compound header is a header made of two or more mnemonics 
separated by colons. The mnemonic created contains no spaces. The 
following rules apply to traversing the tree: 

• A leading colon or a < program message terminator > (either a 
< NL > or EOI true on the last byte) places the parser at the 
root of the command tree. A leading colon is a colon that is the 
first character of a program header. 

• Executing a subsystem command places you in that subsystem 
(until a leading colon or a < program message terminator > is 
found). In the Command Tree, figure 4-1, use the last mnemonic 
in the compound header as a reference point (for example 
INITIALIZE) . Then find the last colon above that mnemonic 
(MMEM:), and that is where the parser will be. Any command 
below that point can be sent within the current program message 
without sending the mnemonic(s) which appear above them 
(STORE, etc.). 



Exa m pies The following examples are written using HP BASIC 5.0 on a HP 9000 
Series 200/300 Controller. The quoted string is placed on the bus, 
followed by a carriage return and linefeed (CRLF). 

The three Xs (XXX) shown in this manual after an ENTER or 
OUTPUT statement refers to the device address for either HP-IB or 
RS-232C. 

Example 1 : output xxx^systeiwheader on;longform on' 

In example 1, the colon between SYSTEM and HEADER is necessary 
since SYSTEM:HEADER is a compound command. The semicolon 
between the HEADER command and the LONGFORM command is 
the required < program message unit separator > . The LONGFORM 
command does not need SYSTEM preceding it, since the 
SYSTEMrHEADER command sets the parser to the SYSTEM node 
in the tree. 
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Example 2: OUTPUT XXX;":MMEMORY:INITIALIZE;STORE 'FILE_7FILE DESCRIPTION'" 
or 

OUTPUT XXX;":MMEMORY:INITIALIZE" 

OUTPUT XXX,":MMEMORY:STORE , FILE_', , FILE DESCRIPTION'" 

In the first line of example 2, the "subsystem selector" is implied for the 
STORE command in the compound command. The STORE 
command must be in the same program message as the INITIALIZE 
command, since the < program message terminator > will place the 
parser back at the root of the command tree. 

A second way to send these commands is by placing "MMEMORY:" 
before the STORE command as shown in the fourth line of example 2. 

Example 3: OUTPUT XXX;":MMEM:CATALOG?;:SYSTEM:PRINT ALL" 

In example 3, the leading colon before SYSTEM tells the parser to go 
back to the root of the command tree. The parser can then see the 
SYSTEMiPRINT command. 
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Infinity 

Representation 



The representation of infinity is 9.9E + 37 for real numbers and 32767 
for integers. This is also the value returned when a measurement 
cannot be made. 



Sequential and 

Overlapped 

Commands 



IEEE 488.2 makes the distinction between sequential and overlapped 
commands. Sequential commands finish their task before the 
execution of the next command starts. Overlapped commands run 
concurrently, and therefore the command following an overlapped 
command may be started before the overlapped command is 
completed. Some examples of overlapped commands on the HP 
16500A are: 

START 
STOP 



Response 
Generation 



IEEE 488.2 defines two times at which query responses may be 
buffered. The first is when the query is parsed by the instrument and 
the second is when the controller addresses the instrument to talk so 
that it may read the response. The HP 16500A will buffer responses to 
a query when it is parsed. 
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Notation The following conventions are used in this manual in descriptions of 

Conventions remote (KF-IB and RS-232C) operation: 

and Definitions < > Angular brackets enclose words or characters that are used to 

symbolize a program code parameter or a bus command. 

::= "is defined as." For example, A ::= B indicates that A can be 
replaced by B in any statement containing A . 

| "or" : Indicates a choice of one element from a list. For example, 
A | B indicates A or B, but not both. 

... An ellipsis (trailing dots) is used to indicate that the preceding 
element may be repeated one or more times. 

[ ] Square brackets indicate that the enclosed items are optional. 

{ } When several items are enclosed by braces, one, and only one of 
these elements must be selected. 

XXX Three Xs after an ENTER or OUTPUT statement refer to the 
device address for HP-IB or RS-232C. 

The following definitions are used: 

d :: = A single ASCII numeric character, 0-9. 

n :: = A single ASCII non-zero, numeric character, 1-9. 

< NL > :: = Linefeed (ASCII decimal 10). 

<sp> ::= < white space > 

white space :: = 0 through 32 (decimal) except linefeed (decimal 10) 

<msus> ::= < mass storage unit specifier > (INTeraall specifies the 
front disc drive and INTernalO specifies the rear disc drive) 
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Syntax 
Diagrams 



At the beginning of each of the following chapters are syntax diagrams 
showing the proper syntax for each command. All characters 
contained in a circle or oblong are literals, and must be entered exactly 
as shown. Words and phrases contained in rectangles are names of 
items used with the command and are described in the accompanying 
text of each command. Each line can only be entered from one 
direction as indicated by the arrow on the entry line. Any combination 
of commands and arguments that can be generated by following the 
lines in the proper direction is syntactically correct. An argument is 
optional if there is a path around it. When there is a rectangle which 
contains the word "space," a white space character must be entered. 
White space is optional in many other places. 



Command 
Structure 



The HP 16500A programming commands are divided into three types: 
common commands, mainframe commands, and subsystem commands. 
A programming command tree is shown in figure 4-1 and a 
programming command cross-reference is shown in table 4-2. 



Common The common commands are the commands defined by IEEE 4882. 
Commands These commands control some functions that are common to all IEEE 
488.2 instruments. Sending the common commands do not take the 
instrument out of a selected subsystem. 

Mainf rame The mainframe commands control many of the basic functions of the 
Commands instrument. 



Expansion Frame 
Commands 



When an HP 16501A Expansion frame is connected to the HP 16500A 
mainframe most of the programming is not affected and is transparent. 
The only commands affected by the presence of an HP 16501A are 
those that specify a slot number or return a slot number. These 
commands are identified in their respective descriptions. 
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Subsystem There are several subsystems in this instrument. Only one subsystem 
Commands ma Y De selected at any given time. At power on, the command parser is 

set to the root of the command tree, and therefore, no subsystem is 

selected. 

igfil When a < program message terminator > or a leading colon (:) is sent 
Note w in a program message, the command parser is returned to the root of 
the command tree. 



The 3 subsystems in the HP 16500A mainframe are: 

• System - controls some basic functions of the instrument. 

• Mmemory - provides access to both internal disc drives. 

• Intermodule - allows intermodule arming between multiple 
modules. 



pfOy rSffi The program examples given for each command in the following 

Examoles chapters and appendices were written on an HP 9000 Series 200/300 

" controller using HP BASIC 5.0 language. The programs always assume 

a generic address of XXX. If a printer is used, it is always assumed to 
be connected to the non-controller interface and activated by the 
:SYSTEM:PRINT command. 

In these examples, special attention should be paid to the ways in which 
the command/query can be sent. The way the instrument is set up to 
respond to a command/query has no bearing on how you send the 
command/query. That is, the command/query can be sent using the 
longf orm or shortform if one exists for that command. You can send 
the command/query using upper case (capital) letters or lower case 
(small) letters; both work the same. Also, the data can be sent using 
almost any form you wish. If you were sending a channel 1 range value 
to the oscilloscope module of 100 mV, that value could be sent using a 
decimal (.1), or an exponential (le-1 or 1.0E-1), or a suffix (100 mV or 
100MV). 



gig The contents of a string is case sensitive and must be expressed exactly 
Note 4lr the same each time it is used. 
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Note & 



Note Sii 



As an example, set channel 1 range of the oscilloscope module to 100 
mV by sending one of the following: 

• commands in longform and using the decimal format. 
OUTPUT XXX,":CHANNEL1:RANGE .1" 

• commands in shortform and using an exponential format. 
OUTPUT XXX;*:CHAN1:RANG 1E-1" 

• commands using lower case letters, shortforms, and a suffix. 
OUTPUT XXX;":char»1:rang 100 mV 



In these examples, the colon shown as the first character of the 
command is optional on the HP 16500A. The space between RANGE 
and the argument is required. 



To observe the headers for queries, you must bring the returned data 
into a string variable. Generally, you should also dimension all string 
variables before reading the data. 

If you do not need to see the headers and a numeric value is returned 
from the HP 16500A, then you should use a numeric variable. In this 
case the headers should be turned off. 



The contents of strings " " are case sensitive (label names, etc.). 
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Command Set 
Organization 



The command set for the HP 16500A mainframe is divided into 5 
separate groups: Common commands, mainframe commands and 3 
sets of subsystem commands. Each of the 5 groups of commands is 
described in the following chapters. Each of the chapters contain a 
brief description of the subsystem, a set of syntax diagrams for those 
commands, and finally, the commands for that subsystem in 
alphabetical order. The commands are shown in the longform and 
shortform using upper and lowercase letters. As an example SELect 
indicates that the longform of the command is SELECT and the 
shortform of the command is SEL. Each of the commands contain a 
description of the command and its arguments, the command syntax, 
and a programming example. 



■IK Each module within the HP 16500A will include additional sets of 
Not 6 *w subsystem commands. For a list of these subsystem commands, refer to 
the individual programming manuals for each module. 
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Table 4-2. Alphabetic Command Cross-Reference 



Command 


Where Used 


Command 


Where Used 


AUToload 


MMEMory Subsystem 


:MMEMory 


Subsystem Selector 


BEEPer 


Mainframe Command 


MSI 


MMEMory Subsystem 


CAPability? 


Mainframe Command 


*OPC 


Common Command 


CARD cage? 


Mainframe Command 


*OPT? 


Common Command 


CATalog? 


MMEMory Subsystem 


PACK 


MMEMory Subsystem 


*CLS 


Common Command 


♦PRE 


Common Command 


COPY 


MMEMory Subsystem 


PRINt 


SYSTem Subsystem 


DEBug 


Mainframe Command 


PURGe 


MMEMory Subsystem 


DELete 


INTermodule Subsystem 


REName 


MMEMory Subsystem 


DOWNload 


MMEMory Subsystem 


RMODe 


Mainframe Command 


DSP 


SYSTem Subsystem 


*RST 


Common Command j 


EOI 


Mainframe Command 


SELect 


Mainframe Command 


ERRor? 


SYSTem Subsystem 


SETColor 


Mainframe Command 


*ESE 


Common Command 


SETup 


SYSTem Subsystem 


*ESR? 


Common Command 


SKEW 


INTermodule Subsystem 


HEADer 


SYSTem Subsystem 


SOUNd 


Mainframe Command 


HTIMe? 


INTermodule Subsystem 


*SRE 


Common Command 


*IDN? 


Common Command 


STARt 


Mainframe Command 


INITialize 


MMEMory Subsystem 


♦STB? 


Common Command 


INPort 


INTermodule Subsystem 


STOP 


Mainframe Command 


INSert 


INTermodule Subsystem 


STORe 


MMEMory Subsystem 


:INTermodule 


Subsystem Selector 


:SYSTem 


Subsystem Selector 


•1ST? 


Common Command 


TREE 


INTermodule Subsystem 


LER? 


Mainframe Command 


♦TRG 


Common Command 


LOAD 


MMEMory Subsystem 


♦TST? 


Common Command 


LOCKout 


Mainframe Command 


TTTMe? 


INTermodule Subsystem 


LONGform 


SYSTem Subsystem 


UPLoad? 


MMEMory Subsystem 


MENU 


Mainframe Command 


*WAI 


Common Command 
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Introduction The common commands are defined by the IEEE 4882 standard. 

These commands will be common to all instruments that comply with 
this standard. 

The common commands control some of the basic instrument 
functions, such as instrument identification and reset, how status is 
read and cleared, and how commands and queries are received and 
processed by the instrument. 

Common commands can be received and processed by the HP 16500A 
whether they are sent over the bus as separate program messages or 
within other program messages. If an instrument subsystem has been 
selected and a common command is received by the instrument, the 
instrument will remain in the selected sybsystem. For example if the 
program message 

":MMEM0RY:INITIALI2E;*CLS; STORE 'FILE_7DESCRIPTION*" 

is received by the instrument, the instrument will initialize the disc and 
store the file; and clear the status information. This would not be the 
case if some other type of command were received within the program 
message. For example, the program message 

■:MMEM0RY:INITIAL12E;:SELECT 1 ; : MMEMORY: STORE 'FILE^.'DESCRIPTION*" 

would initialize the disc, select the module in slot A, then store the file. 
In this example :MMEM ORY must be sent again in order to reenter 
the mmemory subsystem and store the file. 
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Each status register has an associated status enable (mask) register. By 
setting the bits in the mask value you can select the status information 
you wish to use. Any status bits that have not been masked (enabled in 
the enable register) will not be used to report status summary 
information to bits in other status registers. 

Refer to Appendix B, "Status Reporting" for a complete discussion of 
how to read the status registers and how to use the status information 
available from this instrument. 

Refer to figure 5-1 for the common commands syntax diagram. 
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-*- (*zsE?y - 

-H ^»ESR?) - 



(«IST?^)- 



(«OPC?)- 



(»CLS) - 



-»» ^»OPT?y 

-*^prT)— 



/- N 

PRE?j- 



-- («STB?) - 



-» (»TST?y 
^»- (»WAl) — 



space 



pre_mask 




mask = ^4/i integer, 0 through 255. This number is the sum of all the bits 
in the mask corresponding to conditions that are enabled. Refer to the 
*ESE and *SRE commands for bit definitions in the enable regsters. 

pre_mask = An integer, 0 through 65535. This number is the sum of all 
bits in the mask corresponding to conditions that are enabled. Refer to 
the *PRE command for bit definitions in the enable register. 



Figure 5-1. Common Commands Syntax Diagram 
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*CLS 



*CLS (clear status) command 

The *CLS common command clears all event status registers, queues, 
and data structures, including the device defined error queue and 
status byte. If the *CLS command immediately follows a < program 
message terminator > , the output queue and the MAV (Message 
Available) bit will be cleared. 

Command Syntax: *cls 

Example: output xxx;"*clS" 



ijgj Refer to Appendix B, "Status Reporting" for a complete discussion of 
Note W status. 
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r ESE (Event status Enable) command/query 

The *ESE command sets the Standard Event Status Enable Register 
bits. The Standard Event Status Enable Register contains a mask value 
for the bits to be enabled in the Standard Event Status Register. A one 
in the Standard Event Status Enable Register will enable the 
corresponding bit in the Standard Event Status Register which sets the 
ESB bit in the status byte. A zero will disable the bit. Refer to table 
5-1 for information about the Standard Event Status Enable Register 
bits, bit weights, and what each bit masks. 



The *ESE query returns the current contents of the enable register. 



l|g| Refer to Appendix B, "Status Reporting" for a complete discussion of 
Note W status. 



Command Syntax: *ese <mask> 
where: 
< mask > :: = 0 to 255 (integer) 

Example: output xxx;"*ese 32" 

In this example, the *ESE 32 command will enable CME (Command 
Error), bit 5 of the Standard Event Status Enable Register. Therefore, 
when a command error occurs, the event summary bit (ESB) in the 
Status Byte Register will also be set. 
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Query Syntax: *ese? 
Returned Format: <mask><NL> 
Example: 10 dim Event$[ioo] 

20 OUTPUT XXX,"*ESE?" 
30 ENTER XXX; Events 
40 PRINT Events 
50 END 

Table 5-1. Standard Event Status Enable Register 



Bit 


Weight 


Enables 


7 


128 


PON -Power On 


6 


64 


URQ - User Request 


5 


32 


CME - Command Error 


4 


16 


EXE - Execution Error 


3 


8 


DDE - Device Dependent Error 


2 


4 


QYE - Query Error 


1 


2 


RQC - Request Control 


0 


1 


OPC - Operation Complete 



High - enables the ESR bit 
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*ESR 



*ESR 



(Event Status Register) 



query 



The *ESR query returns the contents of the Standard Event Status 
Register. Reading the register clears the Standard Event Status 
Register. 



Query Syntax: *esr? 
Returned Format: < status >< nl> 
where: 
< status > :: = 0 to 255 (integer) 
Example: 10 DIM Esr_event$[100] 



20 OUTPUT XXX,"*ESR?" 
30 ENTER XXX;Esr_event$ 
40 PRINT Esr_event$ 
50 END 

With the example, if a command error has occurred the variable 
"Esr_event" will have bit 5 (the CME bit) set. 

Table 5-2 shows the Standard Event Status Register. The table shows 
each bit in the Standard Event Status Register, and the bit weight. 
When you read Standard Event Status Register, the value returned is 
the total bit weights of all bits that are high at the time you read the 
byte. 
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Table 5-2. The Standard Event Status Register 



Hit 


Dll TV CI gill 




i^unuiutin 


7 


128 


PON 


0 = register read - not in power up mode 

1 = power up 


6 


64 


URQ 


0 = user request - not used - always zero 


5 


32 


CME 


0 = no command errors 

1 = a command eror has been detected 


4 


16 


EXE 


0 = no execution errors 

1 = an execution error has been detected 


3 


8 


DDE 


0 = no device dependent error has been detected 

1 = a device dependent error has been detected 


2 


4 


QYE 


0 = no query errors 

1 = a query error has been detected 


1 


2 


RQC 


0 = request control - not used- always zero 


0 


1 


OPC 


0 — operation is not complete 

1 = operation is complete 
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*IDN 



(Identification Number) 



query 



The *IDN? query allows the instrument to identify itself. It returns the 
string: 

"HEWLETT-PACKARD,16500A,0,REV < revision code>" 

An *IDN? query must be the last query in a message. Any queries 
after the *IDN? in the program message will be ignored. 



Query Syntax: *idn? 
Returned Format: hewlett-packard,16500A,o,rev < revision code> 



< revision code > :: = four digit code in the format XX.XX representing the current ROM revision 
Example: 10 dim id$[ioo] 



where: 



20 OUTPUT XXX;"*IDN?" 
30 ENTER XXX; Id $ 
40 PRINT ld$ 
50 END 
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*IST 



(Individual Status) 



query 



The *IST query allows the instrument to identify itself during parallel 
poll by allowing the controller to read the current state of the IEEE 
488.1 defined "ist" local message in the instrument. The response to 
this query is dependent upon the current status of the instrument. 

Figure 5-2 shows the *IST data structure. 



Query Syntax: *ist? 



Returned Format: <id><NL> 



where: 



<id>:: = Oor 1 



1 :: = indicates the "ist" local message is false 



0:: - indicates the "ist" local message is true 



Example: 10 dim Event$[ioo] 



20 OUTPUT XXX;"*IST?" 
30 ENTER XXX; Event! 
40 PRINT Event$ 
50 End 
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*IST 



DEVICE DEFINED 
CONDITIONS 



INDIVIDUAL 
STATUS 
•1ST? 



DEVICE DEFINED CONDITIONS 



SUMMARY MESSAGE 



1 I I 1 I 1 I I M I U 1 1 I 



15 


14 


13 


12 


11 


10 


9 


8 



15 



© 



13 



©1 



12 



© 



10 



7 


MSS 


ESB 


MAV 


LCL 


2 


1 


MSB 



© 



© 



H>1 
Hi 



STATUS BYTE 
REGISTER 
• STB? 



PARALLEL POLL 
ENABLE REGISTER 
•PRE 
• PRE? 



Figure 5-2. *IST Data Structure 
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OPC 



(Operation Complete) 



command/query 



The *OPC command will cause the instrument to set the operation 
complete bit in the Standard Event Status Register when all pending 
device operations have finished. The commands which affect this bit 
are the Overlapped Commands. An Overlapped Command is a 
command that allows execution of subsequent commands while the 
device operations initiated by the Overlapped Command are still in 
progress. Some examples of overlapped commands for the HP 16500A 
are: 

STARt 
STOP 

Additional overlapped commands are defined in the individual 
programming manuals for each module. 

The *OPC query places an ASCII "1" in the output queue when all 
pending device operations have been completed. 



Command Syntax: *opc 

Example: output xxx/*opc 

Query Syntax: *opc? 

Returned Format: 1 < nl> 

Example: dim Status$[ioo] 

20 OUTPUT XXX^OPC?' 
30 ENTER XXX; Statu s$ 
40 PRINT Status$ 
50 END 



Common Commands 
5-12 



HP 16500A/16501A 
Programming Reference 



*OPT 



*OPT (Option Identification) query 

The *OPT query identifies the software installed in the HP 16500A. 
This query returns nine parameters. The first parameter indicates 
whether you are in the System. The next two parameters indicate any 
software options installed, and the next parameter indicates whether 
intermodule is available for the System. The last five parameters list 
the installed software for the modules in slot A through E for an HP 
16500A mainframe. When an HP 1650 1A Expansion frame is 
connected, there will be ten parameters after the INTERMODULE 
for modules in slots A through J. A zero in any of the last eight 
parameters indicates that the corresponding software is not currently 
installed. 

Query Syntax: *opt? 

Returned Format: {SYSTEM} P {< option > |0},{<option> |0},{INTERMODULE|0},{<module> |0}, 
{< module > |0},{< module > |0},{< module > |0},{< module > |0} 
[,{<module> |0},{<module> |0},{<module> |0},{<module> |0}, 
{ < module > 1 0}] < NL> 

where: 

< option > :: = name of software option 
< module > :: = name of module software 



The name returned for software options and module software is the 
Note 'W same name that appears in the field in the upper-left corner of the 
menu for each option or module. 



Example: 10 dim option$[200j 

20 OUTPUT XXX,**OPT?" 
30 ENTER XXX; Option$ 
40 PRINT Options 
50 END 
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*PRE 



*PRE 



(Parallel Poll Enable Register Enable) 



command/query 



The *PRE command sets the parallel poll register enable bits. The 
Parallel Poll Enable Register contains a mask value which is ANDed 
with the bits in the Status Bit Register to enable an "ist" during a 
parallel poll. The query returns the current value of the register. 

Refer to table 5-3 for the bits in the Parallel Poll Enable Register and 
what they mask. 



This example will allow the HP 16500A to generate an "ist" when a 
message is available in the output queue. When a message is available, 
the MAV (Message Available) bit in the Status Byte Register will be 
high. 



Command Syntax: *pre <mask> 



where: 



< prejnask > :: = 0 to 65535 (integer) 



Example: 



Output XX*"*PRE 16" 



Query Syntax: 



■*PRE?" 



Returned format: 



<mask><NL> 



where: 



< mask > :: = sum of all bits that are set - 0 through 65535 



Example: 



10 DIM Pre_va!ue$[100] 
20 OUTPUT XXXi"*PRE?" 
30 ENTER XXX;Pre_value$ 
40 PRINT Pre value$ 
50 END 



Common Commands 
5-14 



HP 16500A/16501A 
Programming Reference 



*PRE 



Table 5-3. HP 16500A Parallel Poll Enable Register 



Bit 


Weight 


Enables 


15-8 




Not used 


7 


128 


Not used 


6 


64 


MSS - Master Summary Status 


5 


32 


ESB - Event Status 


4 


16 


MAV - Message Available 


3 


8 


LCL - Local 


2 


4 


Not used 


1 


2 


Not used 


0 


1 


MSB - Module Summary 
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*RST (Reset) command 

The *RST command (488.2) is not implemented on the HP 16500A. 
The HP 16500A will accept this command, but the command has no 
affect on the instrument. 



l|K The *RST command is generally used to place the instrument in a 
Note W predefined state. Since the HP 16500A allows you to store predefined 
configuration files for individual modules or the entire system, resetting 
the instrument can be accomplished by simply loading the appropriate 
configuration file. For more information, refer to the chapter 
"Mmemory Subsystem" in this manual. 
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f SRE (Service Request Enable) COmmand/query 

The *SRE command sets the Service Request Enable Register bits. 
The Service Request Enable Register contains a mask value for the bits 
to be enabled in the Status Byte Register. A one in the Service 
Request Enable Register will enable the corresponding bit in the Status 
Byte Register. A zero will disable the bit. Refer to table 5-4 for the 
bits in the Service Request Enable Register and what they mask. 

The *SRE query returns the current value. 

jlgl Refer to Appendix B, "Status Reporting" for a complete discussion of 
Note W status. 



Command Syntax: *sre <mask> 
where: 
< mask > :: = 0 to 255 (integer) 

Example: output xxx,'-sre is" 

This example enables a service request to be generated when a 
message is available in the output queue. When a message is available, 
the MAV (Message Available) bit will be high. 
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Query Syntax: *sre? 
Returned Format: < mask >< nl > 
where: 

< mask > :: = sum of all bits that are set - 0 through 255 

Example: 10 DIM Sre_value$[100] 
20 OUTPUT XXX/*SRE?" 
30 ENTER XXX;Sre_value$ 
40 PRINT Sre value$ 
50 END 

Table 5-4. HP 16500A Service Request Enable Register 



Bit 


Weight 


Enables 


15-8 




not used 


7 


128 


not used 


6 


64 


MSS - Master Summary Status 


5 


32 


ESB - Event Status 


4 


16 


MAV - Message Available 


3 


8 


LCL- Local 


2 


4 


not used 


1 


2 


not used 


0 


1 


MSB - Module Summary 
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r STB (status Byte) query 

The *STB query returns the current value of the instrument's status 
byte. The MSS (Master Summary Status) bit and not RQS (Request 
Service) bit is reported on bit 6. The MSS indicates whether or not the 
device has at least one reason for requesting service. Refer to table 5-5 
for the meaning of the bits in the status byte. 

glgi Refer to Appendix B, "Status Reporting" for a complete discussion of 
Note W status. 



Query Syntax: *stb? 
Returned Format: < value > < nl> 
where: 

< value > :: = 0 through 255 (integer) 
Example: ioDiMStb_vaiue$[ioo] 

20 OUTPUT XXX;"*STB?" 
30 ENTER XXX, Stb value$ 
40 PRINT Stb_value$ 
50 END 
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Table 5-5. The Status Byte Register 



Bit 


Bit Weight 


Bit Name 


Condition 


7 


128 




0 = not Used 


6 


64 


MSS 


0 = instrument has no reason for service 

1 = instrument is requesting service 


5 


32 


ESB 


0 = no event status conditions have occurred 1 

1 = an enabled event status condition has occurred 


4 


16 


MAV 


0 = no output messages are ready 

1 = an output message is ready 


3 


8 


LCI- 


0 = a remote-to-local transition has not occurred 

1 = a remote-to-local transition has occurred 


2 


4 




not used 


1 


2 




not used 


0 


1 


MSB 


0 = a module or the system has activity to report 

1 = no activity to report 



0 = False = Low 

1 = True = High 
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*TRG (Trigger) command 

The *TRG command has the same effect as a Group Execute Trigger 
(GET). That effect is as if the START command had been sent for 
intermodule group run. If no modules are configured in the 
Intermodule menu, this command has no effect. 

Command Syntax: *trg 

Example: output xxx;"*trg" 
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*TST 



(Test) 



query 



The *TST query returns the results of the power-up self-test. The 
result of the test is a 9-bit mapped value which is placed in the output 
queue. A one in the corresponding bit means that the test failed and a 
zero in the corresponding bit means that the test passed. Refer to table 
5-6 for the meaning of the bits returned by a TST? query. 



Query Syntax: *tst? 
Returned Format: < result >< nl> 
where: 

< result > :: = 0 through 51 1 (integer) 

Example: 10 output xxx/*tst?" 



20 ENTER XXX;Tst_value 
30 PRINT Tst value 
40 END 
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Table 5-6. Bits Returned by *TST? Query 
(Power-Up Test Results) 



Bit 


Bit Weight 


Test 


8 


256 


Front Disk Text 


7 


128 


Rear Disk Test 


6 


64 


Touchscreen Test 


5 


32 


(not used - always zero) 


4 


16 


(not used - always zero) 


3 


8 


Display Test 


2 


4 


Interupt Test 


1 


2 


RAM Test 


0 


1 


ROM Test 
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*WAI 



(Wait) 



command 



The * WAI command causes the device to wait until the completion of 
all overlapped commands before executing any further commands or 
queries. An overlapped command is a command that allows execution 
of subsequent commands while the device operations initiated by the 
overlapped command are still in progress. Some examples of 
overlapped commands for the HP 16500A are: 



Additional overlapped commands are defined in the individual 
programming manuals for each module. 



STARt 
STOP 



Command Syntax: *wai 



Example: output xxx,"*wai" 
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Introduction 



Mainframe commands control the basic operation of the instrument for 
both the HP 16500A alone or with the HP 16501A connected. They 
can be called at anytime, and from any module. The only difference in 
mainframe commands with an HP 16501A connected is the number of 
slots and modules. These differences will be noted in the affected 
command descriptions. Refer to figure 6-1 for the Mainframe 
commands syntax diagram. 



r<D- 



JSEEPer)- 




-»(CESE?3- 



^— j space | r-+{ j3FF\e) - 

,0N| 1 



^CAPobi I i ty?)- 



2> 



£01?^ 

s 

LER? 



0- 



- ^LOCKout?^ )- 



space | r-— (OFF |g) — r- 



Figure 6-1. Mainframe Commands Syntax Diagram 
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(menu) - 



-^ (ucsz) - 
-» (mese) - 



-fc ^RMODe) - 



inc 



enoble_value 



"I indCX I <1> 

3 <!> 







) 


■ pace j- 



y- — ^SINGIe ) j- 

^-—(RSPe t i t i ve)— — 



(sELect) — 



(SETCol o7) 1 » {pEFoult) - 



-— (sETColor?) — | space | » » { eo lor | 

-»» (sTARt) 

(stop) 



value = integer, 0 to 65535. 

module = integer, -2 to 5 (HP 1650QA only), or -2 to 10 (HP 16501A connected) 

menu = integer. Refer to the individual programming manuals for each module and the system for 

specific menu number definitions. 

enable_value = integer, 0 to 255. 

index = integer, 0 to 5. 

color = integer, Oto 7. Color number 0 cannot be changed. 
hue = integer, 0 to 100. 
sat = integer, 0 to 100. 
lum = integer, 0 to 100. 



Figure 6-1. Mainframe Commands Syntax Diagram (Continued) 
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BEEPer 



command/query 

The BEEPer command sets the beeper mode, which turns the beeper 
sound of the instrument on and off. When BEEPer is sent with no 
argument, the beeper will be sounded without affecting the current 
mode. The query returns the mode currently selected. 



Command Syntax: : BEEPer [{ON|i}|{OFFjo}] 



Examples: 



OUTPUT XXX;':BEEPER" 
OUTPUT XXXi":BEEP ON" 



Query Syntax: : BEEPer? 
Returned Format: [: BEEPer] {1 |o} <nl> 



i_Aaiii|_MC. 



* /i mil n.j.^r^nAl 

iu uiivi iviuuc^l iuuj 

20 OUTPUT XXX;":BEEPER?" 
30 ENTER XXX; Mode$ 
40 PRINT Mode$ 
50 END 
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CAPability 

query 

The CAPability query returns the HP-SL and lower level capability sets 
implemented in the device. 

Table 6-1 lists the capability sets implemented in the HP 16500A 
:CAPability? 

[:CAPability] IEEE488.1987.SH1 ,AH1 J5.L4.SR1 ,RL1 ,PP1 ,DC1 ,DT1 .C0.E2 < NL> 

10 DIM Response$[100] 
20 OUTPUT XXX;*:CAPABILITY?" 
30 ENTER XXX; Responses 
40 PRINT Responses 
50 END 

Table 6-1. HP 16500A Capability Sets 



Mnemonic 


Capability Name 


Implementation 


SH 


Source Handshake 


SHI 


AH 


Acceptor Handshake 


AH1 


T 


Talker (or TE - Extended Talker) 


T5 


L 


Listener (or LE - Extended Listener) 


L4 


SR 


Service Request 


SRI 


RL 


Remote Local 


RL1 


PP 


Parallel Poll 


PP1 


DC 


Device Clear 


DC1 


DT 


Device Trigger 


DTI 


C 


Any Controller 


CO 


E 


Electrical Characteristic 


E2 



CAPability 



Query Syntax: 

Returned Format: 
Example: 
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CARDcage 



query 



The CARDcage query returns a series of integers which identifies the 
modules that are installed in the mainframe. For an HP 16500A alone, 
the first five numbers returned are the card identification numbers (a 
-1 means no card is in the slot). The remaining five numbers returned 
indicate the module assignment for each card. The possible values for 
the module assignment are 0, 1, 2, 3, 4, and 5 where 0 indicates an 
empty slot or the module software is not recognized or not loaded. 
1...5 indicates the number of the slot in which the master card for this 
card is located. 

When an HP 16501A is connected, the first ten numbers returned are 
the card identification numbers (a -1 means no card is in the slot). The 
remaining ten numbers returned indicate the module assignment for 
each card. The possible values for the module assignment are 0 
through 10 where 0 indicates an empty slot or the module software is 
not recognized or not loaded. 1...10 indicates the number of the slot in 
which the master card for this card is located. 

Table 6-2 lists the card identification numbers for the first five 
parameters and their associated cards. 



<ID>,<1D>,<ID>,<ID>,<ID>,[<ID>,<ID>,<ID>,<ID>,<ID>,] 

< assign > , < assign > , < assign > , < assign > , < assign > 

[, < assign > , < assign > , < assign > , < assign > , < assign > ] < NL > 



Query Syntax: 



: CARDcage? 



Returned Format: 



[: CARDcage] 



where: 



< ID> :: - card identification number (integer) 



< assign >::= module assignment (integer) 



Example: 



10 DIM Card$[100] 

20 OUTPUT XXX^CARDCAGE?* 

30 ENTER XXX; Card$ 

40 PRINT Card$ 

50 END 
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Table 6-2. Card Identification Numbers 



Id Number 


Card 


31 


HP 16510A or B Logic Analyzer Card 


1 


HP 16515A 1 GHz Timing Master Card 


2 


HP 16516A 1 GHz Timing Expansion Card 


21 


HP 16520A Pattern Generator Master Card 


22 


HP 16521A Pattern Generator Expansion Card 


11 


HP 16530A Oscilloscope Timebase Card 


12 


HP 16531A Oscilloscope Acquisition Card 


40 


HP 16540A Logic Analyzer Card 


41 


HP 16541A Logic Analyzer Card 



■|g& Refer to the individual programming manuals for each module for 
Note W cards not listed in table 6-2. 
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C ES E (Combined Event Status Enable) COmmand/query 

The CESE command sets the Combined Event Status Enable register. 
This register is the enable register for the CESR register and contains 
the combined status of all of the MESE (Module Event Status Enable) 
registers of the HP 16500A. The query returns the current setting. 

Table 6-3 lists the bit values for the CESE register. 

Command Syntax: :CESE < value > 

where: 

< value > :: = 0 to 65535 (integer) 

Example: output xxx^cese 32" 
Query Syntax: :CESE? 
Returned Format: [:CESE] < value > <nl> 
Example: 

10 DIM Setting$[100j 
20 OUTPUT XXX;":CESE?" 
30 ENTER XXX;Setting$ 
40 PRINT Setting! 
50 END 
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Table 6-3. HP 16500A Combined Event Status Enable Register 



Bit 


Weight 


Enables 


11-15 




not used 


10 


1024 


Module in slot J 


9 


512 


Module in slot I 


8 


256 


Module in slot H 


7 


128 


Module in slot G 


6 


64 


Module in slot F 


5 


32 


Module in slot £ 


4 


16 


Module in slot D 


3 


8 


Module in slot C 


2 


4 


Module in slot B 


1 


2 


Module in slot A 


0 


1 


Intermodule 
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CESR 



(Combined Event Status Register) 



query 



The CESR query returns the contents of the Combined Event Status 
register. This register contains the combined status of all of the 
MESRs (Module Event Status Registers) of the HP 16500A. Table 6-4 
lists the bit values for the CESR register. 



Query Syntax: :CESR? 
Returned Format: [:CESR] < value >< nl> 
where: 

< value > :: = 0 to 65535 (integer) 



Example: 



10 DIM Event$[1QQ] 
20 OUTPUT XXX^CESR?" 
30 ENTER XXX; Event$ 
40 PRINT Event$ 
50 END 
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Table 6-4. HP 16500A Combined Event Status Register 



Bit 


Bit Weight 


Bit ISame 


Condition 


11-15 






0 = not used 


10 


1024 


Module J 


0 = No new status 

1 = Status to report 


9 


512 


Module I 


0 = No new status 

1 — Status to report 


8 


256 


Module H 


0 = No new status 

1 = Status to report 


7 


128 


Module G 


0 = No new status 

1 = Status to report 


6 


64 


Module F 


0 = No new status 

1 = Status to report 


5 


32 


Module E 


0 = No new status 

1 = Status to report 


4 


16 


Module D 


0 = No new status 

1 = Status to report 


3 


8 


Module C 


0 = No new status 

1 = Status to report 


2 


4 


Module B 


0 = No new status 

1 = Status to report 


1 


2 


Module A 


0 = No new status 

1 = Status to report 


0 


1 


Intermodule 


0 = No new status 

1 = Status to report 
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EOl 



(End Or Identify) 



command/query 



The EOl command specifies whether or not the last byte of a reply 
from the instrument is to be sent with the EOl bus control line set true 
or not. If EOl is turned off, the box will no longer be sending 488.2 
compliant responses. The query returns the current status of EOl. 



Command Syntax: : eoi {{ON|1}|{OFF|0}} 

Example: output xxx;":EOi on" 

Query Syntax: :EOi? 

Returned Format: [:EOi] {1 |o} <nl> 



Example: 



10 DIM Mcde$[100] 
20 OUTPUT XXX^EOr?" 
30 ENTER XXX; Mod e$ 
40 PRINT Mode$ 
50 END 
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LER (LCL Event Register) query 

The LER query allows the LCL Event Register to be read. After the 
LCL Event Register is read, it is cleared. A one indicates a 
remote-to-local transition has taken place. A zero indicates a 
remote-to-local transition has not taken place. 

Query Syntax: :LER? 

Returned Format: [:LER] {o|i}<nl> 

Example: 10 dim Event$[ioo] 

20 OUTPUT XXX;":LER7" 
30 ENTER XXX; Event$ 
40 PRINT Events 
50 END 
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LOCKout command/query 

The LOCKout command locks out or restores front panel operation. 
When this function is on, all controls (except the power switch) are 
entirely locked out. The LOCKout query returns the current status of 
the LOCKout command. 



Command Syntax: ±ocKout {{ON| 1} |{Off|o}} 

Example: output xxxj": lockout on- 

Query Syntax: :LOCKout? 

Returned Format: [-.LOCKout] {o| 1} < nl> 

Example: 10 dim status$poo] 

20 OUTPUT XXX;":LOCKCUT?' 
30 ENTER XXX;Status$ 
40 PRINT Status$ 
50 END 



HP 16500A/16501A 
Programming Reference 



Mainframe Commands 
6-13 



MENU 



MENU command/query 

The MENU command puts a menu on the display. The first parameter 
specifies the desired module. The optional second parameter specifies 
the desired menu in the module (defaults to 0). 

Command Syntax: :MENU < module >[,< menu >] 

where: 

<module > :: = selects module or system (integer-2 to 5 for HP 16500A only), (integer -2 to 10 
with HP 1 6501 A connected) 

< menu > :: = selects menu (integer) 
Example: output xxx;":MENU0,r 
For the first parameter: 

0 - System/Intermodule 

1 - Module in slot A 

2 - Module in slot B 

3 - Module in slot C 

4 - Module in slot D 

5 - Module in slot E 

6 - Module in slot F 

7 - Module in slot G 

8 - Module in slot H 

9 - Module in slot X 

10 - Module in slot J 
-1 - Software option 1 
-2 - Software option 2 

For the System: 

MENU 0,0 - System Configuration menu 

MENU 0,1 - Rear disc menu 

MENU 0,2 - Front disc menu 

MENU 03 - Utilities menu 

MENU 0,4 - Test menu 

MENU 0,5 - Intermodule menu 



Only available when an 
HP 16501 A is connected 
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lg|& Refer to the individual programming manuals for each module for 
Note 'w specific menu number definitions for each module. 



The MENU query returns the current menu selection. 
Query Syntax: :MENU? 
Returned Format: [:menu] < module >,< menu ><nl> 

Example: 10 DIM Response$[100] 

20 OUTPUT XXX;":MENU?" 
30 ENTER XXX;Response$ 
40 PRINT Responses 
50 END 
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MESE<N> 



(Module Event Status Enable) 



command/query 



The MESE command sets the Module Event Status Enable register. 
This register is the enable register for the MESR register. The < N > 
index specifies the module, and the parameter specifies the enable 
value. For the HP 16500A only, the <N> index 1...5 refers to module 
in slot A...E and 0 refers to intermodule. When an HP 16501A is 
connected , the <N> index 1...10 refers to module is slot A.. J. The 
query returns the current setting. 

Refer to table 6-5 and the individual programming manuals for each 
module for information about the Module Event Status Enable register 
bits, bit weights, and what each bit masks. 

Command Syntax: :MESE<N> <enable_value> 

where: 

<N>:: = integer 0 through 5 (HP 16500A only integer), integer 0 through 10 (HP 16501 A 
connected). 

< enablevalue > :: = 0 through 255 (integer) 

Example: output xxx^mesei 3" 
Query Syntax: :MESE<n>? 

Returned Format: [:MESE<N>] <enable_value><NL> 

Example: 10 dim Event$[ioo] 

20 OUTPUT XXX;':MESE1?" 
30 ENTER 707; Event$ 
40 PRINT Event$ 
50 END 
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Table 6-5. HP 16500A Mainframe (Intermodule) Module Event 
Status Enable Register 



Bit 


Weight 


Enables 


7 


128 


not used 


6 


84 


not used 


5 


32 


not used 


4 


16 


not used 


3 


8 


not used 


2 


4 


not used 


1 


2 


RNT - Intermodule Run Until Satisfied 


0 


1 


MC - Intermodule Measurement Complete 
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MESR< N > 



MESR<N> 



(Module Event Status Register) 



query 



The MESR query returns the contents of the Module Event Status 
register. The <N> index specifies the module. For the HP 16500A 
only, 1...5 refers to module in slot A...E and 0 refers to intermodule. 
When an HP 16501A is connected, the < N > index 1...10 refers to 
module is slot A.. J 

Refer to table 6-6 and the individual programming manuals for each 
module for information about the Module Event Status Register bits 
and their bit weights. 



<N>::= integer 0 through 5 (HP 16500 A only integer), integer 0 through 10 (HP 16501 A 
connected). 



Query Syntax: 



:MESR<N>? 



Returned Format: 



[: MESR < N > ] < enable_value >< NL > 



where: 



< enable_value > :: = 0 through 255 (integer) 



Example: 10 dim Event$[ioo] 



20 OUTPUT XXX;":MESR1?" 
30 ENTER XXX; Event$ 
40 PRINT Event$ 
50 END 
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Table 6-6. HP 16500A Mainframe Module Event Status Register 



Bit 


Bit Weight 


Bit iName 


Condition 


7 


128 




0 = not used 


6 


64 




0 = not used 


5 


32 




0 = not used 


4 


16 




0 = not used 


3 


8 




0 = not used 


2 


4 




0 = not used 


1 


2 


RNT 


0 = Intermodule Run until not satisfied 

1 = Intermodule Run until satisfied 


0 


1 


MC 


0 = Intermodule Measurement not satisfied 

1 = Intermodule Measurement satisfied 
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RMODe command/query 

The RMODe command specifies the run mode for the selected module 
(or Intermodule). The query returns the current setting. If the 
selected module is in the intermodule configuration, then the 
"intermodule" run mode will be set by this command. 

jjgl After specifying the run mode, use the STARt command to start the 
Not© ^IP acquisition. 



Command Syntax: :RMODe {SINGIe | REPetitive} 

Example: output xxx,":Rmode single- 
Query Syntax: : RMODe? 

Returned Format: [:RMODe] {SINGIe | REPetitive} < NL> 

Example: 10 dim Mode$[ioo] 

20 OUTPUT XXX;": RMODE?" 
30 ENTER XXX; Mode$ 
40 PRINT Mode$ 
50 END 
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SELect command/query 

The SELect command selects which module (or system) will have 
parser control. The appropriate module (or system) must be selected 
before any module (or system) specific commands can be sent. 
SELECT 0 selects System, SELECT 1 through 5 selects modules A 
through E in an HP 16500A only. SELECT 1 through 10 selects 
modules A through J when an HP 16501A is connected. -1 and -2 
selects software options 1 and 2 respectively. The query returns the 
current module selection. 



Figure 6-2 shows the command tree for the SELect command. 



Note 



4 



SELect defaults to System (0) at power up. 



Command Syntax: .SELect < module > 
where: 

< module > :: = integer -2 through 5 (HP 16500 A only), integer -2 through 10 (HP 16501A 
connected). 

Example: output xxx/iSELect 0" 
Query Syntax: :SELect? 

[: SELect] < module ><NL> 



Returned Format: 
Example: 



10 DIM Module$[100] 
20 OUTPUT XXX;":SELECT?" 
30 ENTER XXX; Module$ 
40 PRINT Modules 
50 END 
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SELect 



: SELECT 



Only available when an 
HP 16501 A is connected ■ 



-1 - 
-2- 



( SELECTS SYSTEM/INTERMODULE) 

(SELECTS MODULE IN SLOT A) 

(SELECTS MODULE IN SLOT B) 

(SELECTS MODULE IN SLOT C) 

(SELECTS MODULE IN SLOT D) 

(SELECTS MODULE IN SLOT E) 



MODULE 


IN 


SLOT 


fj 


SIS 


IN 


SLOT 


G) 




§| 


SLOT 


11 


MorMk 


m 


|lo| 


11 


:*Mobtke : 


M 


SLOT 


p 



(SELECTS OPTION 1) 
(SELECTS OPTION 2) 



Figure 6-2. Select Command Tree 



tfgl When a module is selected, the parser recognizes the module's 
Note *w commands and the System/Intermodule commands. When SELECT 0 
is used, only the System/Intermodule commands are recognized by the 
parser. 
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SETColor 



command/query 



The SETColor command is used to change one of the color selections 
on the CRT, or to return to the default screen colors. Four parameters 
are sent with the command to change a color: 

• Color Number (first parameter), 

• Hue (second parameter), 

• Saturation (third parameter), and 

• Luminosity (last parameter). 

Command Syntax: :SETColor {<color> f <hue>,<sat>,<lum> I DEFault} 
where: 
< color > :: = 0 to 7 (integer) 

< hue > :: = 0 to 100 (integer) 

< sat > :: = 0 to 100 (integer) 
<lum>::= Oto 100 (integer) 



Note 

Example 



Color Number 0 cannot be changed. 



Query Syntax: 

Returned Format: 
Example: 



OUTPUT XXX;": SETCOLOR 3,60,100,60" 
OUTPUT XXX;":SETC DEFAULT" 

The SETColor query returns the hue, saturation, and luminosity values 
for a specified color. 

:SETColor? < color > 

[:SETColor] <color>,<hue>,<sat>,<lum><NL> 

10 DIM Color$[100] 

20 OUTPUT XXX;': SETCOLOR? 3" 

30 ENTER XXXjCc!or$ 

40 PRINT Color$ 

50 END 
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STARt command 

The STARt command starts the selected module (or Intermodule) 
running in the specified run mode (see RMODe). If the specified 
module is in the Intermodule configuration, then the "Intermodule" run 
will be started. 



The STARt command is an Overlapped Command. An Overlapped 
Command is a command that allows execution of subsequent 
commands while the device operations initiated by the Overlapped 
Command are still in progress. For more information, refer to the 
*OPC and *WAI commands in the chapter "Common Commands." 



Command Syntax: :STARt 

Example: output xxxj':STARr 



Note 4? 
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STOP command 

The STOP command stops the selected module (or Intermodule). If 
the specified module is in the Intermodule configuration, then the 
"Intermodule" run will be stopped. 



The STOP command is an Overlapped Command. An Overlapped 
Command is a command that allows execution of subsequent 
commands while the device operations initiated by the Overlapped 
Command are still in progress. For more information, refer to the 
*OPC and *WAI commands in the chapter "Common Commands." 



Command Syntax: :Stop 

Example: output xxx,":STOP" 



Note '-J? 



HP 16500A/16501A 
Programming Reference 



Mainframe Commands 
6-25 



O I O I dll ^UUOyOLCIII 



Introduction 



SYSTem subsystem commands control functions that are common to 
all modules, including formatting query responses and enabling reading 
and writing to the advisory line of the instrument. Refer to figure 7-1 
for the System Subsystem commands syntax diagram. 



»*{7sYSTem) — *-(T)~ 



-*® — 

-*^ERRor?)- 



-H^HEADeT)- 



(HEADer?) - 



{ j.ONGfornT )- 



space 



space 



space 



space 



-y-H 



b I ock_data 



str ing 



NUMer ic 




-»{ j.ONGform?^ )- 



Figure 7-1. System Subsystem Commands Syntax Diagram 
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y 



block data = data in IEEE 488.2 # format. 
string = string of up to 68 alphanumeric characters. 



Figure 7-1. System Subsystem Commands Syntax Diagram (Continued) 
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DATA 



Note 



4 



command/query 

The DATA command transmits the data part of the setup 
configuration of the selected module in block data format. The DATA 
query returns the current contents of the acquisition buffer from the 
selected module to the controller. 



The DATA command is only used in conjunction with modules that are 
loaded in the mainframe. The System does not contain any acquired 
data. 



Command Syntax: :SYSTem:DATA < block data in # format > 

Query Syntax: :SYSTem:DATA? 

Returned Format: [:SYSTem:DATA] < block data in # format >< NL> 

Definition Of Block data in the # format is made up of a block length specifier and a 
BlOCk Data variable number of sections. 

< block length specifier > < section 1 > < section 2> 

The block length specifier is defined as follows: 

#8 < length > 

where: 

< length > :: = the total length of all sections in byte format (must be represented with 8 digits) 
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For example, if the total length of the block (all the sections) is 144 
bytes, the block length specifier would be "#800000144" since the 
length must be represented with 8 digits. 

Sections consist of a section header followed by the section data as 
follows: 

< section header > < section data> 

where: 

< section header > :: = 10 bytes for the section name 
1 byte reserved (always 0) 
1 byte for the module ID number (see table 7-1) 
4 bytes for the length of the section data in bytes 

The section data format varies for each section and may be any length. 



The total length of a section is 16 (for the section header) plus the 
length of the section data. Thus, when calculating the length of a block 
of configuration data, care should be taken to not forget to add the 
length of the section headers. 



Note d 



HP-IB Example: 10 dim Biock$[32000] 

20 DIM Specifier$[2] 

30 OUTPUT XXX;':EOI ON" 

40 OUTPUT XXX;":SYSTEM:HEAD OFP 

50 OUTPUT XXX;":SELECT 4" 

60 OUTPUT XXX;*: SYSTEM: DATA?" 

70 ENTER XXX USING "#,2A";Specifier$ 

80 ENTER XXX USING "#,8D";Blocklength 

90 ENTER XXX USING "-K";Block$ 

100 END 



lallocate enough memory for block data 



(select module 
isend data query 
iread in #8 
(read in block length 
Iread in data 
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Table 7-1. Card Identification Numbers 



ID number 


Card 


31 


HP 16510A or B Logic Analyzer Card 


1 


HP 16515A 1 GHz Timing Master Card 


2 


HP 16516A 1 GHz Timing Expansion Card 


21 


HP 16520A Pattern Generator Master Card 


22 


HP 165 15A Pattern Generator Expansion Card 


11 


HP 16530A Oscilloscope Timebase Card 


12 


HP 16531A Oscilloscope Acquisition Card 


40 


HP 16540A Logic Analyzer Card 


41 


HP 16541A Logic Analyzer Card 
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DSP 



(Display) 



command 



The DSP command writes the specified quoted string to a device 
dependent portion of the instrument display. 

Command Syntax: :SYSTem:DSP <string> 

where: 

< string > :: = string of up to 68 alphanumeric characters 
Example: OUTPUT XXX;":SYSTEM:DSP The message goes here'" 
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ERRor query 

The ERRor query returns the oldest error from the error queue. The 
optional parameter determines whether the error string should be 
returned along with the error number. If no parameter is received, or 
if the parameter is NUM, then only the error number is returned. If 
the value of the parameter is STRing, then the error should be returned 
in the following form: 

< error number >, < error message (string) > 

A complete list of error messages for the HP 16500A mainframe is 
shown in appendix C. If no errors are present in the error queue, a 
zero (No Error) is returned. 

Query Syntax: :SYSTem: ERRor? [NUMeric | STRing] 

Returned Formats: Numeric: 

[:SYSTem: ERRor] <error number><NL> 

String: 

[:SYSTem: ERRor] < error number > , < string >< NL > 

where: 
< error number >::= integer 
Examples: Numeric: 

10 OUTPUT XXX;":SYSTEM: ERROR?" 
20 ENTER XXX; Numeric 
30 PRINT Numeric 
40 END 

String: 

10 DIM String$[100] 

20 OUTPUT XXX;":SYST:ERR? STRING" 
30 ENTER XXX;String$ 
40 PRINT String$ 
50 END 
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HEADer 



command/query 



Command Syntax: 

Example: 
Query Command: 

Returned Format: 
Example: 



Note ^ 



The HEADer command tells the instrument whether or not to output a 
header for query responses. When HEADer is set to ON, query 
responses will include the command header. 

The HEADer query returns the current state of the HEADer 
command. 

:SYSTem: HEADer {{ON|1}|{OFF|0}} 
OUTPUT XXX;": SYSTEM: HEADER ON" 
:SYSTem: HEADer? 
[: SYSTem : HEADer] {1 |0}<NL> 
10 DIM Mode$[100] 

20 OUTPUT XXX;":SYSTEM:HEADER?" 
30 ENTER XXX; Mod e$ 
40 PRINT Mode$ 
50 END 

Headers should be turned off when returning values to numeric 
variables. 
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LONGform 



command/query 



The LONGform command sets the longform variable which tells the 
instrument how to format query responses. If the LONGform 
command is set to OFF, command headers and alpha arguments are 
sent from the instrument in the abbreviated form. If the the 
LONGform command is set to ON, the whole word will be output. 
This command has no affect on the input data messages to the 
instrument. Headers and arguments may be input in either the 
longform or shortform regardless of how the LONGform command is 
set. The query returns the status of the LONGform command. 



Command Syntax: 



:SYSTem:LONGform {{ON 1 1 } | {OFF 1 0}} 



Example: 



OUTPUT XXX;":SYSTEM:LONGFORM ON" 



Query Syntax: 



:SYSTem:LONGform? 



Returned Format: 



[:SYSTem:LONGform] {1 |0}<NL> 



Example: 



10 DIM Mode$[100] 

20 OUTPUT XXX,-":SYSTEM:LONGFORM?" 
30 ENTER XXX; Mode$ 
40 PRINT Mode$ 
50 END 
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PRINt 



command/query 

The PRINt command initiates a print of the screen or listing buffer 
over the current PRINTER communication interface. The query sends 
the screen or listing buffer data over the current CONTROLLER 
communication interface. 



if jj The print query should NOT be sent in conjunction with any other 
Note w command or query on the same command line. 

The print query never returns a header. Also, since response data from 
a print query may be sent directly to a printer without modification, the 
data is not returned in block mode. 



Command Syntax: :SYSTem:PRINt{SCReen|ALL} 

Example: OUTPUT XXX;":SYSTEM:PRINT SCREEN" 
Query Syntax: SYSTem: PRINT? {SCReen I ALL} 



Note 



PRINT? ALL is only available in menus that have the "Print All" option 
available on the front panel. For more information, refer to the 
individual front-panel manuals for each module. 



HP-IB Example: 10 OUTPUT 707;":SYSTEM: PRINT? SCREEN" 
20SEND7;UNT UNL 
30SEND7;USTEN1 
40 SEND 7;TALK7 
50 SEND 7; DATA Idrop ATN line 
60 PRINT "WAITING FOR PRINT" 
70 END 
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SETup 



Command Syntax: 
Query Syntax: 

Returned Format: 

Definition of 
Block Data 



command/query 

The SETup command configures the selected module (or System) as 
defined by the block of data sent by the controller. The query returns a 
block of data that contains the current configuration for the selected 
module (or System) to the controller. 

:SYSTem:SETup <block data In # format> 

:SYSTem:SETup? 

[:SYSTem:SETup] <block data in # format> < NL> 

Block data in the # format is made up of a block length specifier and a 
variable number of sections. 



< block length specifier > < section 1 > < section 2> 
The block length specifier is defined as follows: 
#8 < length > 

where: 

< length > :: = the total length of all sections in byte format (must be represented with 8 digits) 



For example, if the total length of the block (all the sections) is 144 
bytes, the block length specifier would be "#800000144" since the 
length must be represented with 8 digits. 

Sections consist of a section header followed by the section data as 
follows: 

< section header > < section data> 

where: 

< section header > :: = 10 bytes for the section name 
1 byte reserved (always 0) 
1 byte for the module ID number (see table 7-2) 
4 bytes for the length of the section data in bytes 
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The section data format varies for each section and may be any length. 

tlgl The total length of a section is 16 (for the section header) plus the 
Note <P length of the section data. Thus, when calculating the length of a block 
of configuration setup data, care should be taken to not forget to add 
the length of the section headers. 



HP-IB Example: 10 dim Biock$[32000] 
20 DIM Specifier$[2] 
30 DIM Blocklength$[8] 
40 OUTPUT XXX^EOI ON" 
50 OUTPUT XXX;":SYSTEM: HEAD OFF 
60 OUTPUT XXXi-rSELECTO" 
70 OUTPUT XXX;":SYSTEM:SETUP?" 
80 ENTER XXX USING "#,2A";Specifier$ 
90 ENTER XXX USING "iWiBlocklengthS 
100 ENTER XXX USING MCjBlockS 
1 10 Blocklength = IVAL(Blocklength$,10) 
200 ! 

210 ! Send setup back to the HP 16500A 
220! 

230 OUTPUT XXX USING "#,14A";":SYSTEM:SETUP" 

240 OUTPUT XXX USING NWjSpecifierS 

250 OUTPUT XXX USING "#,8A";Blocklength$ 

260 OUTPUT XXX USING •"&VAL$(Blocklength)&'A";Block$ 



lallocate enough memory for block data 



•select System 
isend setup query 
Iread in #8 
Iread in block length 
Iread in data 

iconvert block string to integer 



300 END 
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Table 7-2. Card Identification Numbers 



ID Number 


Card 


31 


HP 16510A or B Logic Analyzer Card 


1 


HP 16515A 1 GHz Timing Master Card 


2 


HP 16516A I GHz Timing Expansion Card 


21 


HP 16520A Pattern Generator Master Card 


22 


HP 16521A Pattern Generator Expansion Card 


11 


HP 16530A Oscilloscope Timebase Card 


12 


HP 16531A Oscilloscope Acquisition Card 


40 


HP 16540A Logic Analyzer Card 


41 


HP 16541A Logic Analyzer Card 
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Introduction MMEMory (mass memory) subsystem commands provide access to 

both internal disc drives. Refer to figure 8-1 for the MMEMory 
Subsystem commands syntax diagram. 



Note W 



||q < msus > refers to the mass storage unit specifier. INTernall specifies 



the front disc drive and INTernalO specifies the rear disc drive. 

If you are not going to store information to the configuration disc, or if 
the disc you are using contains information you need, it is advisable to 
write protect your disc. This will protect the contents of the disc from 
accidental damage due to incorrect commands, etc. 



»» (:MMEMor"7 ) — **{T^)~^~** C AUTo log< Q ** space | | *- (oFF|b} - 



-y-H 



^■*-| outo_fi 



-* ^AUTolood?^) - 
(cATolog?^ )— 



space 




msus 





Figure 8-1. Mmemory Subsystem Commands Syntax Diagram 
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- ^DOWNIoad) - 



spoce — name 



t r 

^»(V) — «*■ msus — ^ 



space 



space 



^*-(^T) — *" msus — ^ 



descr ipt ion 



type 




J 



b I ock_data 



-o ^INITiol ize) - 



space 




msus 





^— (T) »» (C0NF i 9) —^" 





space 




name 











c 



*• msus — ^ ^***CH) — *" rnodu,e ^ 



•^T) » ^IA5Semblei 



space 




i a_n ame 





c 



n 



<3I> 



-fc ^MSI?) - 



3 



space 




msus 





Figure 8-1. Mmemory Subsystem Commands Syntax Diagram (Continued) 
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-♦■ (pURGe) — 



— *» j apace | ^ msus j ' 



space 



space 



mth: 



^*Kro~ msus — ^ 



new_name 



-— (sTORe) 1 t 

^*-(T) »» (cONF i q) -J 



space 




name 






G 



descr iption 



UPLoad? 





space 




name 




I - 




1 1—' 



auto_file = string of up to 10 alphanumeric characters. 

msus = INTernall \INTernalO 

name = string of up to 10 alphanumeric characters. 

description = string of up to 32 alphanumeric characters. 

type = integer, refer to table 8-1. 

block_data = data in IEEE 488.2 # format. 

iajiame = string of up to 10 alphanumeric characters. 

newjaame = string of up to 10 alphanumeric characters. 

module = integer, lto5 (HP 16500A only), or 1 to 10 (HP 16501A connected). 



Figure 8-1. Mmemory Subsystem Commands Syntax Diagram (Continued) 
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AUToload 



command/query 



The AUToload command controls the autoload feature which 
designates a set of configuration files to be loaded automatically the 
next time the instrument is turned on. The OFF parameter (or 0) 
disables the autoload feature. A string parameter maybe specified 
instead to represent the desired autoload file. If the file is on the 
current < msus > , the autoload feature is enabled to the specified file. 

The AUToload query returns 0 if the autoload feature is disabled. If 
the autoload feature is enabled, the query returns a string parameter 
that specifies the current autoload file. The appropriate slot designator 
"_X" is included in the filename. "X" refers to the slot designator A...E 
for the corresponding module for an HP 16500A alone. When an HP 
16501A is connected "X" refers to slot designator A.. J. If the slot 
designator is "_?" the file is for all modules. 

Command Syntax: :MMEMory:AUToload {{OFF|0}l{<auto_file>}}[,<msus>] 
where: 

<auto_file > :: = string of up to 10 alphanumeric characters 
< msus > :: = {INTernaM | INTernalO} 



Examples: 

Query Command: 

Returned Format: 
Example: 



OUTPUT XXX;':MMEMORY:AUTOLOAD OFF" 

OUTPUT XXX;": MMEMORY: AUTOLOAD 'F1LE1 A" 

OUTPUT XXX;":MMEMORY:AUTOLOAD 'FILE2 \INTERNAL1" 

:MMEMory: AUToload? 

[:MMEMory: AUToload] {0 1 < autojile > }, < msus >< NL > 

10 DIM Auto status$[100] 

20 OUTPUT XXX;":MMEMORY:AUTOLOAD?" 

30 ENTER XXX;Auto_status$ 

40 PRINT Auto statu s$ 

50 END 
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CATalog query 

The CATalog query returns the directory of the currently selected disc 
in block data format. The directory consists of a 51 character string for 
each file on the disc. Each file entry is formatted as follows: 

"NNNNNNNNNN ! I i 1 1 1 1 DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD" 

where N is the filename, T is the file type (a number), and D is the file 
descriptor. If the < msus > is not specified, the last disc drive specified 
by the MSI command will be used. 

For more information on block data format, refer to the section 
"Definite-Length Block Response Data" in the chapter 1. 

Query Syntax: : M MEMory: CATalog? [<msus>] 

where: 



< msus > :: = {INTernaH | INTemalO} 
Returned Format: [:MMEMory: CATalog] < block data > 

where: 

< block data >::= < filename > < file type > < file description >... 

Example: 10 dim Rie$[5i] 

20 DIM Specifier$[2] 

30 OUTPUT XXX;": SYSTEM: HEAD OFF 

40 OUTPUT XXXT:MMEMORY:CATALOG? INTERNAL! "'send catalog query 
50 ENTER XXX USING "#,2A";Specifier$ Iread in #8 
60 ENTER XXX USING "#,8D"; Length Iread in length 

70 FOR I = 1 TO Length STEP 51 Iread and print each 

(file in the directory 

80 ENTER XXX USING "#,51 A";Rle$ 
90 PRINT File$ 
100 NEXT I 

110 ENTER XXX USING "A"; Specifiers Iread in final line feed 

120 END 
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COPY 



command 



The COPY command copies one file to a new file or an entire disc's 
contents to another disc. The two < name > parameters are the 
filenames. The first pair of parameters specifies the source file. The 
second pair specifies the destination file. An error is generated if the 
source file doesn't exist, or if the destination file already exists. 

If the filename is not specified for both the source and destination, then 
the entire contents of the source are transferred to the destination 
(same as the Duplicate Disc front panel operation). The previous 
contents of the destination media are destroyed. 

If the < msus > is not specified, the last disc drive specified by the MSI 
command will be used. 



< name > :: = string of up to 10 alphanumeric characters 

< msus > :: = {INTernal 1 1 INTernalO} 

Examples: To copy the contents of "FILE1" to "FILE2" when both files are on a 
disc on the last disc drive specified by the MSI command: 

OUTPUT XXX;":MMEMORY:COPY 'RLE1 '.'FILE*'" 



To copy the contents of TELEl" on the rear disc drive to "FILE2" on 
the front disc drive: 

OUTPUT XXX/:MMEM:COPY , RLE1\INTERNAL0, , RLE2 , ,INTERNAL1" 

To copy the contents of T1LE1" on the last disc drive specified by the 
MSI command to "FILE2" on the rear disc drive: 

OUTPUT XXX;":MMEMORY:COPY 'RLE1 ','RLE2',INTERNAL0" 

To duplicate the contents of the disc in the rear disc drive to a disc in 
the front disc drive: 

OUTPUT XXX;":MMEM:COPY INTERNAL0,INTERNAL1 " 



Command Syntax: 



:MMEMory:COPY [ < name > ][, < msus > ],[ < name > ][, < msus > ] 



where: 
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DOWNIoad command 

The DOWNIoad command downloads a file to the specified mass 
storage device. The < name > parameter specifies the filename, the 

< description > parameter specifies the file descriptor, and the 

< block_data > contains the contents of the file to be downloaded. 

If the < msus > is not specified, the last disc drive specified by the MSI 
command will be used. 

Table 8-1 lists the file types for the < type > parameter. 

Command Syntax: : MMEMory: DOWNIoad < name > [, < msus > ], 

< description > , <type > , < block_data > 

where: 

< name > :: = string of up to 10 alphanumeric characters 
<msus>::= {INTernal0)|INTernal1} 

< description > :: = string of up to 32 alphanumeric characters 

<type > :: = integer (see table 8-1) 

< block_data > :: - contents of file in block data format 

Example: OUTPUT XXX;":MMEMORY:DOWNLOAD , SETUP_MNTERNALO i 'RLE CREATED 
FROM SETUP QUERY',-16127,#800000643..." 
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Table 8-1. File Types 



File 


File Type 


HP 16500A System Software 


-16128 


HP 16500A Mainframe (System) Configuration 


-16127 


HP 16510A or B Logic Analyzer Configuration 


-16096 


HP 16515A 1 GHz Timing Configuration 


-16126 


HP 16520A Pattern Generator Configuration 


-16106 


HP 16530A Oscilloscope Configuration 


-16116 


HP 16540A Logic Analyzer Configuration 


-16087 


HP 16541A Logic Analyzer Configuration 


-16086 


Autoload File 


-15615 


Inverse Assembler 


-15614 


Option Software 


-15613 


Calibration Factors 


-15611 


Text (Generic) Type 


-15610 
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I N ITialize command 

The INITialize command formats the specified disc. If no disc drive is 
specified, then the initializp. command will format the disc in the 
currently selected disc drive. 

Command Syntax: :MMEMory:INmalize [<msus>] 

where: 

<msus>::= {INTernalO|INTernal1} 

Examples: OUTPUT XXX;":MMEMORY:INmAL12E" 

OUTPUT XXX;":MMEMORY:INITIALIZE INTERNALS 



||gj Once executed, the initialize command formats the specified disc, 
Note *w permanently erasing ail existing information from the disc. After that, 
there is no way to retrieve the original information. 
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LOAD [:CONHg] command 

The LOAD command loads a configuration file from the disc into 
modules, software options, or the system. The < name > parameter 
specifies the filename from the specified mass storage device. The 
optional < module > parameter specifies which module(s) to load the 
file into. The accepted values are 0 for system, for the module in 
slot A...E respectively for an HP 16500A alone, and -1, -2 for software 
options 1 and 2 respectively. When an HP 16501A is connected, the 
accepted values are 0 for system, 1...10 for the module in slot A.. J 
respectively, and -1, -2 for software options 1 and 2. Not specifying the 
< module > parameter is equivalent to performing a 'IX) AD ALL' 
from the front panel which loads the appropriate file for every installed 
module, software option, and for the system. 

Command Syntax: :MMEMory:LOAD[:CONfig] < name > [, < msus > ][, < module > ] 

where: 

< name > :: = string of up to 10 alphanumeric characters 

<msus>::= {INTernal0|INTemal1} 

< module > :: = integer, -2 through 5 (HP 16500A alone), or -2 through 10 (HP 16501 A 
connected) 

Examples: OUTPUT XXX/:MMEMORY:LOAD:CONFlG 'F!LE_" 
OUTPUT XXX,":MMEMORY:LOAD 'F1LE_\0" 
OUTPUT XXX;":MMEM:LOAD:CONRG 'FILE_A',INTERNAL1,r 
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LOAD :iASSembier command 

This variation of the LOAD command allows inverse assembler files to 
be loaded into a module that performs state analysis. The 
< IA name > parameter specifies the inverse assembler filename from 
the desired < msus > . The parameter after the optional < msus > 
specifies which machine to load the inverse assembler into. 

The optional < module > parameter is used to specify which slot the 
state analysis module is in. 1...5 refers to the module in slot A...E for an 
HP 16500A alone. When an HP 16501A is connected, 1...10 refers to 
module A.. J. If this parameter is not specified, the state analysis 
module closest to slot A is selected. 

Command Syntax: :MMEMory:LOAD:IASSembler <lA_name> [,<msus>].{1 j2}[,< module >] 

where: 

< lA_name > :: = string of up to 10 alphanumeric characters 

< msus > : : = { INTernalO | INTernal 1 } 
< module >:: = integer, 1 through 5 (HP 16500Aonly), or 1 through 10 (HP 16501 A connected) 

Examples: OUTPUT XXX^MMEMORY:LOAD:IASSEMBLER T68020JP\1" 
OUTPUT XXX;":MMEM:LOAD:IASS *I68020JP\INTERNAL1,1,2" 
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MSI (Mass storage is) command/query 

The MSI command selects a default mass storage device. If the 
parameter is omitted, the default mass storage device (front disc drive) 
is selected. The query returns the current MSI setting. 

Command Syntax: :MMEMory:MSI[<msus>] 

where: 

<msus>::= {INTernalO|INTernal1} 

Examples: output xxx/:MMEMORY:Msr 

OUTPUT XXX,':MMEM:MSI INTERNAL1" 

Query Syntax: :MMEMory:MSr? 

Returned Format: [:MMEMory:MSi] <msus> <nl> 

Example: 10 DIM Device$ [100] 

20 OUTPUT XXX;":MMEMORY:MSI?" 
30 ENTER XXX; Device$ 
40 PRINT Device$ 
50 END 
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PACK command 

The PACK command packs the files on a disc on the specified mass 
storage device. If no disc drive is specified, this command will pack the 
disc in the last disc drive specified by the MSI command. 



Command Syntax: :MMEMory:PACK[<msus>] 
where: 

<msus>::= {INTernalO|INTernal1} 
Examples: OUTPUT xxxi":mmemory:pack" 

OUTPUT XXX,":MMEM:PACK INTERNAL!" 
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PURGe command 

The PURGe command deletes a file from the specified mass storage 
device. The '< name > parameter specifies the filename to be deleted. 

Command Syntax: :MMEMory:PURGe <name>[,<msus>] 

where: 

< name > :: = string of up to 10 alphanumeric characters 
<msus>::= {INTernal0|INTernaJ1} 

Examples: OUTPUT XXX;":MMEMORY: PURGE 'RLE1- 

OUTPUTXXX;":MMEM:PURG 'F1LE1 ', INTERNAL©" 

lISj Once executed, the purge command permanently erases all the existing 
Note tMP information from the specified file. After that, there is no way to 
retrieve the original information. 
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REName command 

The REName command renames a file from the specified mass storage 
device. The < name > parameter specifies the filename to be changed 
and the < new_name > parameter specifies the new filename. 

llS& You cannot rename a file to an already existing filename. 

Note SP 

Command Syntax: :MMEMory: REName < name > [, < msus > ], < new_name > 
where: 

< name > :: = string of up to 10 alphanumeric characters 
<msus>::= {INTernal0|INTemaI1} 
< new_name > :: = string of up to 10 alphanumeric characters 

Examples: OUTPUT XXXj":MMEMORY:RENAME 'OLDRLEVNEWFILE'" 

OUTPUT XXXj":MMEM:REN 'OLDFILE'.INTERNALI ,'NEWFILE'" 
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STORe [:CONFig] command 

The STORe command stores module or system configurations onto a 
disc. The [:CONKg] specifier is optional and has no effect on the 
command. The < name > parameter specifies the file on the specified 
mass storage device. The < description > parameter describes the 
contents of the file. The optional < module > parameter allows you to 
store the configuration for a specific module or modules. 1...5 refers to 
the module in slot A...E in an HP 16500A or 1...10 refers to module in 
slot A.. J when an HP 16501A is connected. 0 refers to the system. -1 
and -2 are for software options. 

If the optional < module > parameter is not specified, the 
configurations for all of the modules are stored. 

Command Syntax: :MMEMory:STORe [:CONfig] < name >[,<msus>],< description >[,< module >] 

where: 

< name > :: = string of up to 10 alphanumeric characters 

<msus>::= {INTernal0|INTemal1} 

< description > :: = string of up to 32 alphanumeric characters 

< module > :: = integer, -2 through 5 (HP 16500A only), or -2 through 10 (HP 16501 A 
connected)) 

OUTPUT XXX,":MMEM:STOR 'DEFAULTS'/SETUPS FOR ALL MODULES- 
OUTPUT XXX;':MMEMORY:STORE:CONFIG 'SCOPE',INTERNAL1 ,'SLOT B 
SCOPE CONRG',2" 



The appropriate slot designator "_X" is added to all files when they are 
stored. "X" refers to the letter A...E of the corresponding slot for each 
module in an HP 16500A alone or A.. J when an HP 16501A is 
connected. 



Examples: 

Note 
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UPLoad query 

The UPLoad query uploads a file. The < name > parameter specifies 
the file to be uploaded from the specified mass storage device. The 
contents of the file are sent out of the instrument in block data form. 

•id This command should only be used for HP 165XX or HP 165X files. 

Note W 

Query Syntax: :MMEMory:UPLoad? < name > [, < msus > ] 
where: 

< name > :: = string of up to 10 alphanumeric characters 
<msus>::= {INTema)0|INTemaI1} 



Returned Format: [: MMEMory: UPLoad] < block_data >< NL > 

HP-IB Example: 10 DIM Block$[32000] lallocate enough memory for block data 
20 DIM Specifier$[2] 
30 OUTPUT XXX;":EO! ON" 
40 OUTPUT XXX;":SYSTEM HEAD OFF 

50 OUTPUT XXX;":MMEMORY:UPLOAD? 'F1I_E1 \INTERNAL1 " Isend upload query 

60 ENTER XXX USING "#,2A";Specifier$ Iread in #8 

70 ENTER XXX USING "#,8D";Length Iread in block length 

80 ENTER XXX USING "-K";Block$ Iread in file 

90 END 
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9 

INTermoduie Subsystem 



Introduction 



INTermoduie subsystem commands specify intermodule arming 
between multiple modules. Refer to figure 9-1 for the INTermoduie 
Subsystem commands syntax diagram. 
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Figure 9-1. Intermodule Subsystem Commands Syntax Diagram 
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module = integer, lto5 (HP 1650QA alone), or 1 to 10 (HP 16501A connected). 
index = integer, ltoS (HP 1650QA alone), or 1 to 10 (HP 16S01A connected). 
setting = numeric, -1.0 to 1.0 in seconds. 



Figure 9-1. Intermodule Subsystem Commands Syntax Diagram (Continued) 
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DELete command 

The DELete command is used to delete a module, group of modules, 
PORT OUT, or an entire intermodule tree. The < module > 
parameter sent with the delete command refers to the slot location of 
the module (1...5 modules in slots A...E for the HP 16500A alone or 
1...10 modules in slots A.. J when an HP 16501A is connected). 

Command Syntax: :INTermodule:DELete {ALL I OUT I < module >} 

where: 

<module>::= integer, 1 through 5 (HP 16500Aonly), integer 1 through 10 (HP 16501A 
connected) 

Example: OUTPUT XXX^INTERMODULEDELETE ALL" 
OUTPUT XXX;":INT:DEL 2" 
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HTIMe query 

The HTIMe query returns five values (HP 16500A alone) representing 
the internal hardware skew for all of the modules in the Intermodule 
configuration. When an HP 16501A is connected, the HTIMe query 
returns 10 values. The first value is the skew for the module in slot A, 
the second value is for the module in slot B, the third value is for slot C, 
etc. If there is no internal skew, 9.9E37 is returned. 



ijgg The internal hardware skew is only a display adjustment for time 
Note correlated waveforms. The values returned are the average 

propagation delays of the trigger lines through the intermodule bus 
circuitry for each module. These values are for reference only because 
the values returned by TTTMe include the internal hardware skew 
represented by HTIMe. 



Query Syntax: :INTermodule:HTIMe? 



Returned Format: 



[:INTermodule:HTIMe] 

< vaJue_1 > , < value_2 > , < value_3 > , < value_4 > , < value_5 > 

[, < values > , < value_7 > , < value_8 > , < value_9 >,<value_10>]<NL> 



where: 



<value_1 > :: ■ 
<value_2>:: = 
<vaJue_3>:: : 
<value_4>:: = 
<value_5>::> 
<value_6>" ! 
<value_7>::i 
<value_8>:: : 
<value_9>:: = 
< value 10>:: 



skew for 
skew for 
skew for 
skew for 
skew for 
skew for 
skew for 
skew for 
skew for 
skew for 



module 
module 
module 
module 
module 
module 
module 
module 
module 
module 



in slot A (real number) 
n slot 8 (real number) 
n slot C (real number) 
n slot D (real number) 
n slot E (real number) 
n slot F (real number) 
n slot G (real number) 
n slot H (real number) 
n slot I (real number) 
n slot J (real number) 



Example: 10 DIM Setting$[100] 

20 OUTPUT XXX;":INTERMODULE: HTIME?" 
30 ENTER XXX; Settings 
40 PRINT Settings 
50 END 
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IN Port command/query 

The INPort command causes Intermodule runs to be armed from the 
Input port. The INPort query returns the current setting. 

Command Syntax: :INTermodule:INPort{{ON|1}|{OFF|0}} 

Example: OUTPUT XXX;":INTERMODUL£:INPORT ON" 

Query Syntax: :INTermodule:INPort? 

Returned Format: [:INTermodule:INPort] {1 10} < NL> 

Example: 10 DIM Setting$[100] 

20 OUTPUT XXXj':INTERMODULE:INPORT?" 
30 ENTER XXX;Setting$ 
40 PRINT Settings 
50 END 
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INSert 



command 



The INSert command adds a module or PORT OUT to the 
Intermodule configuration. The first parameter selects the module or 
PORT OUT to be added to the intermodule configuration, and the 
second parameter tells the instrument where the module or PORT 
OUT will be located. 1...5 corresponds to the slot location of the 
module A...E for the HP 16500A alone and 1...10 modules in slots A.. J 
when an HP 16501A is connected . 

Command Syntax: :INTermodule:INSert {< module > |OUT},{GROUP| < module >} 

where: 

< module > :: = integer, 1 through 5 (HP 16500Aonly), integer 1 through 10 (HP 16501 A 
connected) 

Examples: OUTPUT XXX;":INTERMODULE:INSERT 1 .GROUP" 
OUTPUT XXX;MNT:INSERT ^GROUP- 
OUTPUT XXX,-":INTERMODULE:INS 3,2;INS OUT.2" 

The following figure shows the result of the example output commands: 



Group Run 











A 




B 





OUT 
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SKEW < N > command/query 

The SKEW command sets the skew value for a module. The query 
returns the user defined skew setting. The < N> index value is the 
module number (1...5 corresponds to the slot location of the module 
A...E for the HP 16500A alone and 1...10 modules in slots A.. J when 
an HP 16501A is connected) and the < setting > parameter is the skew 
setting (-1.0 to 1.0) in seconds. 

Command Syntax: :INTermodule:SKEW<N> < setting > 

where: 



< N > :: = integer, 1 through 5 (HP 16500A only), integer 1 through 10 (HP 16501A 
connected) 

< setting > :: = -1 .0 to 1 .0 seconds (real number) 

Example: OUTPUT XXX;":INTERMODULE:SKEW2 3.0E-9" 

Query Syntax: :INTermodule:SKEW< N > ? 

Returned Format: [INTermodule:SKEW<N>] <setting > < NL> 

Example: 10 DIM Setting$[100] 

20 OUTPUT XXX;":INTERMODULE:SKEW2?" 
30 ENTER XX*Setting$ 
40 PRINT Settings 
50 END 
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TREE command/query 

The TREE command allows an intermodule setup to be specified in 
one command. The query returns a string that represents the 
intermodule tree. A -1 means the module is not in the intermodule 
tree, a 0 value means the module is armed from the Intermodule run 
button (Group run), and a positive value indicates the module is being 
armed by another module with that slot location (1...5 corresponds to 
the slot location of the module A...E for the HP 16500A alone and 
1...10 modules in slots A.. J when an HP 16501A is connected). 

The first five parameters are the intermodule arm values for modules A 
through J respectively. The last parameter corresponds to the 
intermodule arm value for PORT OUT. 

Command Syntax: :INTermodule:TREE 

< module > , < module > , < module > , < module > , < module > , < module > 

where: 

< module > :: = integer, -1 through 5 (HP 16500A only), integer -1 through 10 (HP 16501 A 
connected)- 

Example: OUTPUT XXXjMNTERMODULEiTREE 0,0,2,-1 ,-1 ,2" 

The following figure shows the result of the example output commands: 



Group Run 



B 



OUT 
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Query Syntax: :INTermodule:TREE? 

Returned Format: [iNTermoduie:TREE] 

< module > , < module > , < module > , < module > , < module > , < module >< NL> 

Example: 10 dim Config$[ioo] 

20 OUTPUT XXX;':INTERMODULE:TREE?" 
30 ENTER XXX;Config$ 
40 PRINT Config$ 
50 END 
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TTIMe 



query 



The TTIMe query returns five values (HP 16500A alone) representing 
the absolute intermodule trigger times for all of the modules in the 
Intermodule configuration. When an HP 16501A is connected, the 
TTIMe query returns 10 values. The first value is the trigger time for 
the module in slot A, the second value is for the module in slot 8, the 
third value is for slot C, etc. 

The value 9.9E37 is returned when: 

• No module is installed in the corresponding slot; 

• The module in the corresponding slot is not time correlated; or 

• A time correctable module did not trigger. 



jjgl The trigger times returned by this command have already been offset 
Note *tr by the INTermodulerSKEW values and internal hardware skews 
(INTermodule:HTIMe). 
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Query Syntax: :INTermodule:TTIMe? 

Returned Format: [:INTermodule:TTIMe] 

< value_1 > , < value_2 > , < value_3 > , < value_4 > , < value_5 > 

[, < value_6 > , < value_7 > , < value_8 > , < value_9 > , < value_1 0 > ] < NL > 



where: 

< valuejl > :: = trigger time for 
<value_2> :: = trigger time for 
< value_3 > :: = trigger time for 
<value_4> :: - trigger time for 
<value_5> :: = trigger time for 
<value_6> :: = trigger time for 
<value_7> :: = trigger time for 
<value_8> :: = trigger time for 
< value_9 > :: = trigger time for 
<value_10::= trigger time for 



module in slot A (real number) 
module in slot B (real number) 
module in slot C (real number) 
module in slot D (real number) 
module in slot E (real number) 
module in slot F (real number) 
module in slot G (real number) 
module in slot H (real number) 
module in slot I (real number) 
module in slot J (real number) 



ExamDles: 10 dim Setting$nooi 

20 OUTPUT XXX;":INTERMODULE:TTIME?" 
30 ENTER XXX; Settings 
40 PRINT Setting! 
50 END 
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Introduction This appendix describes the operation of instruments that operate in 

compliance with the IEEE 488.2 (syntax) standard. The IEEE 4882 
standard is a new standard. Instruments that are compatible with 
IEEE 488.2 must also be compatible with IEEE 488.1 (HP-IB bus 
standard); however, IEEE 488.1 compatible instruments may or may 
not conform to the IEEE 488.2 standard. The IEEE 488.2 standard 
defines the message exchange protocols by which the instrument and 
the controller will communicate. It also defines some common 
capabilities, which are found in all IEEE 488.2 instruments. This 
appendix also contains a few items which are not specifically defmed by 
IEEE 4882. but deal with message communication or system functions. 



The syntax and protocol for RS-232C program messages and response 
Note messages for the HP 16500A are structured very similiar to those 

described by 488.2. In most cases, the same structure shown in this 
appendix for 488.2 will also work for RS-232C. Because of this, no 
additional information has been included for RS-232C. 



Also, the common commands listed in the chapter "Common 
Commands" may be sent over both HP-IB and RS-232C. 
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ProtOCOlS The protocols of IEEE 488.2 define the overall scheme used by the 

controller and the instrument to communicate. This includes defining 
when it is appropriate for devices to talk or listen, and what happens 
when the protocol is not followed. 

Functional Before proceeding with the description of the protocol, a few system 
Elements components should be understood. 

Input Buffer. The input buffer of the instrument is the memory area 
where commands and queries are stored prior to being parsed and 
executed. It allows a controller to send a string of commands to the 
instrument which could take some time to execute, and then proceed to 
talk to another instrument while the first instrument is parsing and 
executing commands. 

Output Queue. The output queue of the instrument is the memory 
area where all output data ( < response messages > ) are stored until 
read by the controller. 

Parser. The instrument's parser is the component that interprets the 
commands sent to the instrument and decides what actions should be 
taken. "Parsing" refers to the action taken by the parser to achieve this 
goal. Parsing and executing of commands begins when either the 
instrument sees a < program message terminator > (defined later in 
this appendix) or the input buffer becomes full. If you wish to send a 
long sequence of commands to be executed and then talk to another 
instrument while they are executing, you should send all the commands 
before sending the < program message terminator > . 



Message Communication and System Functions 
A-2 



HP 16500A/16501A 
Programming Reference 



PrOtOCOl Overview The instrument and controller communicate using < program 

message > s and < response message > s. These messages serve as the 
containers into which sets of program commands or instrument 
responses are placed. < program message > s are sent by the 
controller to the instrument, and < response message > s are sent from 
the instrument to the controller in response to a query message. A 
< query message > is defined as being a < program message > which 
contains one or more queries. The instrument will only talk when it has 
received a valid query message, and therefore has something to say. 
The controller should only attempt to read a response after sending a 
complete query message, but before sending another < program 
message > . The basic rule to remember is that the instrument will only 
talk when prompted to, and it then expects to talk before being told to 
do something else. 



Protocol When the instrument is turned on or when it receives a device clear 
Operation command, the input buffer and output queue are cleared, and the 
parser is reset to the root level of the command tree. 



Note 



tlfil When the instrument receives a device clear command, the module (or 
Tlr system) selected prior to the command remains selected. 



The instrument and the controller communicate by exchanging 
complete < program message > s and < response message > s. This 
means that the controller should always terminate a < program 
message > before attempting to read a response. The instrument will 
terminate < response message > s except during a hardcopy output. 

If a query message is sent, the next message passing over the bus should 
be the < response message > . The controller should always read the 
complete < response message > associated with a query message 
before sending another < program message > to the same instrument. 

The instrument allows the controller to send multiple queries in one 
query message. This is referred to as sending a "compound query." As 
will be noted later in this appendix, multiple queries in a query message 
are separated by semicolons. The responses to each of the queries in a 
compound query will also be separated by semicolons. 
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Commands are executed in the order they are received. This also 
applies to the reception of the HP-IB group execute trigger (GET) bus 
command. The group execute trigger command should not be sent in 
the middle of a < program message > . 

Protocol If an error occurs during the information exchange, the exchange may 
Exceptions not be completed in a normal manner. Some of the protocol 
exceptions are shown below. 

Addressed to talk with nothing to say. If the instrument is addressed 
to talk before it receives a query, it will indicate a query error and will 
not send any bytes over the bus. If the instrument has nothing to say 
because queries requested were unable to be executed because of some 
error, the device will not indicate a query error, but will simply wait to 
receive the next message from the controller. 

Addressed to talk with no listeners on the bus. If the instrument is 
addressed to talk and there are no listeners on the bus, the instrument 
will wait for a listener to listen, or for the controller to take control. 

Command Error. A command error will be reported if the instrument 
detects a syntax error or an unrecognized command header. An HP-IB 
group execute trigger (GET) sent in the middle of a < program 
message > will also cause a command error. 

Execution Error. An execution error will be reported if a parameter is 
found to be out of range, or if the current settings do not allow 
execution of a requested command or query. 

Device-specific Error. A device-specific error will be reported if the 
instrument is unable to execute a command for a strictly device 
dependent reason. 

Query Error. A query error will be reported if the proper protocol for 
reading a query is not followed. This includes the interrupted and 
unterminated conditions described in the following paragraphs. 
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Unterminated Condition. If the controller attempts to read a 

< response message > before terminating the < program message > , a 
query error will be generated. The parser will reset itself, and the 
response will be cleared u om the output queue of the instrument 
without being sent over the bus. 

Interrupted Condition. If the controller does not read the entire 

< response message > generated by a query message and then 
attempts to send another < program message > , the device will 
generate a query error. The unread portion of the response will then 
be discarded by the instrument. The interrupting < program 
message > will not be affected. 

Buffer Deadlock. The instrument may become deadlocked if the input 
buffer and output queue both become full. This condition can occur if 
a very long < program message > is sent containing queries that 
generate a great deal of response data. The instrument cannot accept 
any more bytes, and the controller cannot read any of the response 
data until it has completed sending the entire < program message > . 
Under this condition the instrument will break the deadlock by clearing 
the output queue, and continuing to discard responses until it comes to 
the end of the current < program message > . The query error bit will 
also be set. 



Syntax 
Diagrams 



The syntax diagrams in this appendix are similar to the syntax diagrams 
in the IEEE 4882 specification. Commands and queries are sent to the 
instrument as a sequence of data bytes. The allowable byte sequence 
for each functional element is defined by the syntax diagram that is 
shown with the element description. 

The allowable byte sequence can be determined by following a path in 
the syntax diagram. The proper path through the syntax diagram is any 
path that follows the direction of the arrows. If there is a path around 
an element, that element is optional. If there is a path from right to left 
around one or more elements, that element or those elements may be 
repeated as many times as desired. 
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Syntax This overview is intended to give a quick glance at the syntax defined by 

O VG rvi 6 W IEEE 488.2. It should allow you to understand many of the things 

about the syntax you need to know. This appendix also contains the 

details of the IEEE 4882 defined syntax. 

IEEE 488.2 defines the blocks used to build messages which are sent to 
the instrument. A whole string of commands can therefore be broken 
up into individual components. 

Figure A-l shows a breakdown of an example < program message > . 
There are a few key items to notice: 

1. A semicolon separates commands from one another. Each 

< program message unit > serves as a container for one 
command. The < program message unit > s are separated by a 
semicolon. 

2. A < program message > is terminated by a < NL > (new line) , a 

< NL > with EOI asserted, or EOI being asserted on the last 
byte of the message. The recognition of the < program message 
terminator > , or < PMT > , by the parser serves as a signal for 
the parser to begin execution of commands. The < PMT > also 
affects command tree traversal (see the Progr amming and 
Documentation Conventions chapter). 

3. Multiple data parameters are separated by a comma. 

4. The first data parameter is separated from the header with one or 
more spaces. 

5. The header INTERMODULE:INSERT is an example of a 
compound header. It places the parser in the intermodule 
subsystem until the <NL> is encountered. 

6. A colon preceding the command header returns you to the top of 
the command tree for the selected module. 
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: INTERMODULE: INSERT 3.1; SKEW3 3.8 ns <NL> 



<program message un i t> 
INTERMODULE: INSERT 3 , 1 




<corrmand program header> <program header separator> 
INTERMODULE : INSERT SP 





<program data> 
3 , 1 

71\ A 

SP , SP 



<white space> / <white space> 



<white space> 



<program mnemoniO 
INTERMODULE 



I <program mnemonic> <program data> <program data separotor> <program data> 
INSERT 3 1 



<decimal numeric program dato> <decimal numeric program data> 
3 1 



<program message unit separator> 
SP ; SP 



<program message unit> 
<white space> ; <white space> SKEW3 3.8 ns 



<program message terminator> 
SP <NL> 




<wh i te space> NL 



<program header> <program header separator> <program data> 
SKEW3 SP 3.8 ns 



<white space> <decimal progrom data> <suffix program data> 
3.8 SP ns 



<white space> <suffix multiplier> <suffix unit> 



Figure A-1. < program message > Parse Tree 
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Device Listening The listening syntax of IEEE 488.2 is designed to be more forgiving 
Syntax than the talking syntax. This allows greater flexibility in writing 
programs, as well as allowing them to be easier to read. 

Upper/Lower Case Equivalence. Upper and lower case letters are 
equivalent. The mnemonic SINGLE has the same semantic meaning as 
the mnemonic single. 

< white space > . < white space > is defined to be one or more 
characters from the ASCII set of 0 - 32 decimal, excluding 10 decimal 
(NL). < white space > is used by several instrument listening 
components of the syntax. It is usually optional, and can be used to 
increase the readability of a program. 



/ * s 















<wh i te space 
characters 


) 
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Figure A-2. < white space > 
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< program message > . The < program message > is a complete 
message to be sent to the instrument. The instrument will begin 
executing commands once it has a complete < program message > , or 
when the input buffer becomes full. The parser is also repositioned to 
the root of the command tree after executing a complete < program 
message > . Refer to the Tree Traversal Rules in the Programming and 
Documentation Conventions chapter for more details. 




^ fr» ' 54120/BL39 

Figure A-3. < program message > 

< program message unit > . The < program message unit > is the 
container for individual commands within a < program message > . 



<commond message unit> 



<query message un i t> 



Figure A-4. < program message unit> 
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Figure A-5. < command message unit> 
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< program message unit separator > . A semicolon separates 

< program message unit > s, or individual commands. 





<white space> 




\ 










\ 




/ 
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Figure A-7. < program message unit separator > 

< command program header > / < query program header > . These 
elements serve as the headers of commands or queries. They represent 
the action to be taken. 



<white space> 



<simple command 
program header> 



<compound command 
program heoder> 



<common command 
program header> 



Figure A-8. < command program header > 
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Where < simple command program header > is defined as 





<program 


► 


► 


mnemon i c> 
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Where < compound command program header > is defined as 



<program 
mnemon i c> 



<program 
mnemon i c> 



Where < common command program header > is defined as 



<progr om 
nwi croon t c> 



Where <program mnemonio is defined as 



<upper/ lower 
case alpha> 



<upper/ I ower 
case alpha> 



O 



<digit> 



Where < upper/lower case alpha > is defined as a single ASCII encoded 
byte in the range 41-5A,61-7A (65 - 90, 97 - 122 decimal). 

Where < digit > is defined as a single ASCII encoded byte in the range 30 
-39 (48 - 57 decimal). 

Where ( _) represents an "underscore", a single ASCII-encoded byte with 
the value 5F (95 decimal). 



Figure A-8. < command program header > (continued) 
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<wh i te space> 



<simple query 
program header> 



• — ► 


<compound query 






program header> 


\ 



' — ► 


<cortmon query 


— i — ► 




program header> 
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Where < simple query program header > is defined as 



<progrom 
mnemon i c> 



Where < compound query program header > is defined as 



<progrom 
mnemon i c> 



V 1 




<progrom 






— ► 


mnemon i c> 
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Where < common query program header > is defined as 



<program 
mnemon i c> 



<2> 



Figure A-9. < query program header > 
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< program data > . The < program data > element represents the 
possible types of data which may be sent to the instrument. The 

HP 16500A will accept the following data types: < character program 
data > , < decimal numeric program data > , < suffix program data > , 

< string program data > , and < arbitrary block program data > . 
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Figure A-10. < program data > 





<progrom 




► 




► 
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Figure A-11. < character program data> 
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<mantissa> 




<whi te 




<exponent> 







s 




space> 




/ S 














V 


Ss— 






\ 


— - 


/ 





WTiere <mantisssa> is defined as 



<opt iona I 
d i g i ts> 



\ 




<d i g i t> 


/ 






> 



«J i g i t> 



<op t i ona I 
digi ts> 



< optional digits > is defined as 







<di gi t> 


/ 




\ 
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Where < exponent > is defined as 



<wh i te space> 



<d i g i t> 



Figure A-12. < decimal numeric program data> 



HP 16500A/16501A 
Programming Reference 



Message Communication and System Functions 

A-15 





<v»h i te space> 




<su f fix mu 1 t> 




<su f fix un i t> 










/ 


\ 
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Figure A-13. < suffix program data > 

Suffix Multiplier. The suffix multipliers that the instrument will accept 
are shown in table A-l. 

Table A-1. < suffix mult> 



Value 


\f npmnnir 


1E18 


EX 


1E15 


PE 


1E12 


T 


1E9 


G 


1E6 


MA 


1E3 


K 


1E-3 


M 


1E-6 


U 


1E-9 


N 


1E-12 


P 


IE- 15 


F 


1E-18 


A 



Suffix Unit The suffix units that the instrument will accept are shown 
in table A-2. 

Table A-2. < suffix unit > 



Suffix 


Referenced Unit 


V 
S 


Volt 
Second 
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<inserted'> 





<non— s ingle 




quote char> 






<non— doub 1 e 


► 


quote char> 
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Where < inserted ' > is defined as a single ASCII character with the value 
27 (39 decimal). 

Where < non-single quote char > is defined as a single ASCII character 
of any value except 27 (39 decimal). 

Where < inserted " > is defined as a single ASCII character with the value 
22 (34 decimal). 

Where < non-double quote char > is defined as a single ASCII character 
of any value except 22 (34 decimal) 



Figure A-14. < string program data> 
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# 



<non-zero 
di gi t> 



<d i g i t> 



<8-b i t 
data byte> 



<8-b i t 
data byte> 




NL 



END 
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Where < non-zero digit > is defined as a single ASCII encoded byte in the 
range 31 - 39 (49 - 57 decimal). 

Where < 8-bit byte > is defined as an 8-bit byte in the range 00 -FF (0- 
255 decimal). 

Figure A-15. < arbitrary block program data> 

< program data separator > . A comma separates multiple data 
parameters of a command from one another. 





<white space> 




\ 






/ — - 









o 



<wh i te space> 



Figure A-16. < program data separator > 
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< program header separator > . A space separates the header from 
the first or only parameter of the command. 






<wh i te space> 
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Figure A-17. < program header separator > 

< program message terminator > . The < program message 
terminator > or <PMT > serves as the terminator to a complete 

< program message > . When the parser sees a complete < program 
message > it will begin execution of the commands within that 
message. The < PMT > also resets the parser to the root of the 
command tree. 




Where <NL> is defined as a single ASCII-encoded byte OA (10 
decimal). 

Figure A-18. < program message terminator > 
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: INTERMODULE : INPORT 1 ;: INTERMODULE : SKEW3 3 . 8E-9 <NL> 



<response message un i t> <response message unit separator> 
: INTERMODULE : INPORT 1 




<response header> <response header separotor> <response dato> 

: INTERMODULE: INPORT 



SP 



7 



1 



<response mnemonio <response mnemonio <white space> <NR1 numeric response data> 
INTERMODULE INPORT 1 



<response message un i t> <response message terminator> 

: INTERMODULE : SKEW3 3.8E-9 NL 




<response header> 
INTERMODULE : SKEW3 



7 



<response header separator> <response data> 
SP 3 . 8E-9 



<response mnemonic> <response mnemonic> <white space> <NR3 numeric response data> 
INTERMODULE SKEW3 3.8E-9 



Figure A-19. < response message > Tree 
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Device Talking The talking syntax of IEEE 488.2 is designed to be more precise than 
Syntax the listening syntax. This allows the programmer to write routines 

which can easily interpret and use the data the instrument is sending. 
One of the implications of this is the absence of < white space > in the 
talking formats. The instrument will not pad messages which are being 
sent to the controller with spaces. 

< response message > . This element serves as a complete response 
from the instrument. It is the result of the instrument executing and 
buffering the results from a complete < program message > . The 
complete < response message > should be read before sending 
another < program message > to the instrument. 




54120/BLS7 

Figure A-20. < response message > 

< response message unit> . This element serves as the container of 
individual pieces of a response. Typically a < query message unit > 
will generate one < response message unit > , although a < query 
message unit > may generate multiple < response message unit > s. 

< response header >. The < response header >, when returned, 
indicates what the response data represents. 
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<s imp 1 e 
response 
header> 




\ 




■s 



<compound 
response 
header> 



<corrmon 






response 


^— ► 




heoder> 





Where < simple response mnenomio is defined as 





<response 







mnemon i c> 
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Where < compound response header > is defined as 



<response 




— ► 


<response 




mnemon i c> 






mnemon i c> 





Where < common response header > is defined as 

—0 





<response 




) — - 


mnemon i c> 





Figure A-21. < response message unit> 
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Where < response mnemonio is defined as 



<upper 
case olpho> 



<upper 
cose alpho> 



o 



<digit> 



Where < uppercase alpha > is defined as a single ASCII encoded byte in 
the range 41 - 5A (65 - 90 decimal). 

Where ( _) represents an "underscore", a single ASCII-encoded byte with 
the value 5F (95 decimal). 

Figure A-21. < response message unit > (Continued) 

< response data > . The < response data > element represents the 
various types of data which the instrument may return. These types 
include: < character response data > , < nrl numeric response data > , 

< nr3 numeric response data > , < string response data > , < definite 
length arbitrary block response data > , and < arbitrary ASCII 
response data > . 





<response 




► 


irmemon i c> 


► 
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Figure A-22. < character response data > 
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<d i g i t> 



Figure A-23. < nr1 numeric response data > 




<d i g i t> 



<digi t> 
















<digi t> 


) 







Figure A-24. <nr3 numeric response data > 



<inserted"> 





<non-doub I e 


► 


quote chor> 
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Figure A-25. < string response data > 
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<non-2ero 
digi t> 



<d i q i t> 



<8-bi t 
dato byte> 



Figure A-26. < definite length arbitrary block response data > 



<ASCII 
doto byte> 




NL 



END 



Where < ASCII data byte > represents any ASCII-encoded data byte 
except <NL> (OA, 10 decimal). 



ilia 1- END message provides an unambiguous termination to an 
NotG "w element that contains arbitrary ASCII characters. 

2. The IEEE 488.1 END message serves the dual function of 

terminating this element as well as terminating the < RESPONSE 
MESSAGE > . It is only sent once with the last byte of the indefinite 
block data. The NL is present for consistency with the 
< RESPONSE MESSAGE TERMINATOR > . Indefinite block 
data format is not supported in the HP 16500A. 



Figure A-27. < arbitrary ASCII response data> 
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< response data separator > . A comma separates multiple pieces of 
response data within a single < response message unit > . 
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Figure A-28. < response data separator > 

< response header separator > . A space (ASCII decimal 32) delimits 
the response header, if returned, from the first or only piece of data. 

Figure A-29. < response header separator > 

*{sp) — ► 

&41ZO/B170 

< response message unit separator > . A semicolon delimits the 

< response message unit > s if multiple responses are returned. 




54120/B171 

Figure A-30. < response message unit separator > 

< response message terminator > . A < response message 
terminator > (NL) terminates a complete < response message > . It 
should be read from the instrument along with the response itself. 



ygl If you do not read the < response message terminator > the 
Note W HP 16500A will produce an interrupted error. 
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IEEE 488.2 defines a set of common commands. These commands 
perform functions which are common to any type of instrument. They 
can therefore be implemented in a standard way across a wide variety 
of instrumentation. All the common commands of IEEE 488.2 begin 
with an asterisk. There is one key difference between the IEEE 488.2 
common commands and the rest of the commands found in this 
instrument. The IEEE 488.2 common commands do not affect the 
parser's position within the command tree. More information about 
the command tree and tree traversal can be found in the Progr amming 
and Documentation Conventions chapter. 

Table A-3. HP 16500A's Common Commands 



Command 


Command Name 


*CLS 


Clear Status Command 


*ESE 


Event Status Enable Command 


*ESE? 


Event Status Enable Query 


*ESR? 


Event Status Register Query 


*IDN? 


Identification Query 


*IST? 


Individual Status Query 


*OPC 


Operation Complete Command 


*OPC? 


Operation Complete Query 


♦OPT? 


Option Identification Query 


*PRE 


Parallel Poll Enable Register Enable Command 


*PRE? 


Parallel Poll Enable Register Enable Query 


*RST 


Reset (not implemented on HP 16500A) 


*SRE 


Service Request Enable Command 


*SRE? 


Service Request Enable Query 


*STB? 


Read Status Byte Query 


*TRG 


Trigger Command 


*TST? 


Self-Test Query 


*WAI 


Wait-to-Continue Command 



Common 
Commands 
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Introduction The status reporting features which are available over the bus include 

the serial and parallel polls. IEEE 488.2 defines data structures, 
commands, and common bit definitions for each. There are also 
instrument defined structures and bits. 

The bits in the status byte act as summary bits for the data structures 
residing behind them. In the case of queues, the summary bit is set if 
the queue is not empty. For registers, the summary bit is set if any 
enabled bit in the event register is set. The events are enabled via the 
corresponding event enable register. Events captured by an event 
register remain set until the register is read or cleared. Registers are 
read with their associated commands. The "*CLS" command clears all 
event registers and all queues except the output queue. If "*CLS" is 
sent immediately following a < program message terminator > , the 
output queue will also be cleared. 
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NOTE: THE INDIVIDUAL BIT ASSIGNMENTS FOR THE MODULE EVENT REGISTERS ARE MODULE SPECIFIC. 



INTERMODULE EVENT 

REGISTER 

( MESR0 ) 



















LOGICAL OR 



ENABLE 

REGISTER 

(MESE0) 



HP16501A 
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LOGICAL OR 



MODULE EYENT REGISTER 
FOR MODULE A 
(ME SRI) 

ENABLE 

REGISTER 

(MESE1) 



















LOGICAL OR 



MODULE EVENT REGISTER 
FOR MODULE E 
(MESR5) 



ENABLE 

REGISTER 

(MESE5) 



















LOGICAL OR 



MODULE EVENT REGISTER 
FOR MODULE F 
(MESR6) 



ENABLE 

REGISTER 

(MESE6) 



















LOGICAL OR 



MODULE EVENT REGISTER 
FOR MODULE J 
(MESE10) 

ENABLE 

REGISTER 
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T I It It If T TV 

























LOGICAL OR 





COMBINED EVENT REGISTER 
FOR ALL MODULES 
(CESR) 
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REGISTER 

(CESE) 
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D 
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NOTE: URQ AND ROC NOT IMPLEMENTED 
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S 


A 
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B 


V 
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□ 



STATUS 

BYTE 
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REQUEST 
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REGISTER 
( »SRE ) 



Figure B-1. Status Byte Structures and Concepts 
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Event StatUS The Event Status Register is a 488.2 defined register. The bits in this 
Register register are "latched." That is, once an event happens which sets a bit, 
that bit will only be cleared if the register is read. 

Service Request The Service Request Enable Register is an 8-bit register. Each bit 
Enable Register enables the corresponding bit in the status byte to cause a service 

request. The sixth bit does not logically exist and is always returned as 
a zero. To read and write to this register use the *SRE? and *SRE 
commands. 

Bit Definitions MAV - message available. Indicates whether there is a response in the 
output queue. 

ESB - event status bit Indicates if any of the conditions in the 
Standard Event Status Register are set and enabled. 

MSS - master summary status. Indicates whether the device has a 
reason for requesting service. This bit is returned for the *STB? query. 

RQS - request service. Indicates if the device is requesting service. 
This bit is returned during a serial poll. RQS will be set to 0 after being 
read via a serial poll (MSS is not reset by *STB?). 

PON - power on. Indicates power has been turned on. 

URQ - user request Always 0 on the HP 16500A. 

CME - command error. Indicates whether the parser detected an 
error. 



g|K The error numbers and/or strings for CME, EXE, DDE, and QYE can 
Note W be read from a device defined queue (which is not part of 4882) with 
the query :SYSTEM:ERROR?. 



EXE - execution error. Indicates whether a parameter was out of 
range, or inconsistent with current settings. 

DDE - device specific error. Indicates whether the device was unable 
to complete an operation for device dependent reasons. 
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QYE - query error. Indicates whether the protocol for queries has 
been violated. 

RQC - request control. Always 0 on the HP 16500A. 

OPC - operation complete. Indicates whether the device has 
completed all pending operations. OPC is controlled by the *OPC 
common command. Because this command can appear after any other 
command, it serves as a general purpose operation complete message 
generator. 

LCL - remote to local. Indicates whether a remote to local transition 
has occurred. 

MSB - module summary bit Indicates that an enable event in one of 
the modules Status registers has occurred. 

KGy Features A few of the most important features of Status Reporting are listed in 
the following paragraphs. 

Operation Complete. The IEEE 488.2 structure provides one 
technique which can be used to find out if any operation is finished. 
The *OPC command, when sent to the instrument after the operation 
of interest, will set the OPC bit in the Standard Event Status Register. 
If the OPC bit and the RQS bit have been enabled a service request 
will be generated. The commands which affect the OPC bit are the 
overlapped commands. 

OUTPUT XXX;"*SRE 32 ; *ESE 1" 'enables an OPC service request 

Status Byte. The Status Byte contains the basic status information 
which is sent over the bus in a serial poll. If the device is requesting 
service (RQS set), and the controller serial polls the device, the RQS 
bit is cleared. The MSS (Master Summary Status) bit (read with 
*STB?) and other bits of the Status Byte are not be cleared by reading 
them. Only the RQS bit is cleared when read. To see how the RQS 
and MSS bits are set and used, see figure B-2. 

The Status Byte is cleared with the *CLS common command. 
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STATUS SUMMARY MESSAGES • 



SERVICE 
REQUEST 
GENERATION 



{ 
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6 
MSS 



ESB 



ii 



MAV 



© 



© 



© 

A 



© 



\ 



READ BY SERIAL POLL 



- STATUS BIT REGISTER 
I READ BY «STB? 





5 


A 


3 


2 


1 


e 



SERVICE REQUEST 
ENABLE REGISTER 
*SRE <NRf> 
«SRE? 



Figure B-2. Service Request Enabling 
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Serial Poll 



The HP 16500A supports the IEEE 488.1 serial poll feature. When a 
serial poll of the instrument is requested, the RQS bit is returned on bit 
6 of the status byte. 



Using Serial Poll This example will show how to use the service request by conducting a 
(HP-IB) serial poll of all instruments on the HP-IB bus. In this example, assume 
that there are two instruments on the bus; a Logic Analysis System at 
address 7 and a printer at address 1. 

The program command for serial poll using HP BASIC 4.0 is Stat = 
SPOLL(707). The address 707 is the address of the Logic Analysis 
System in the this example. The command for checking the printer is 
Stat = SPOLL(701) because the address of that instrument is 01 on 
bus address 7. This command reads the contents of the HP-IB Status 
Byte Register into the variable called Stat. At that time bit 6 (RQS bit) 
of the variable Stat can be tested to see if it is set (bit 6 = 1). 

The serial poll operation can be conducted in the following manner: 

1. Enable interrupts on the bus. This allows the controller to "see" 
the SRQ line. 

2. Disable interrupts on the bus. 

3. If the SRQ line is high (some instrument is requesting service) 
then check the instrument at address 1 to see if bit 6 of its status 
register is high. 
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4. To check whether bit 6 of an instruments status register is high, 
use the following Basic statement: 

!F B!T (Stat, 6) THEN 

5. If bit 6 of the instrument at address 1 is not high, then check the 
instrument at address 7 to see if bit 6 of its status register is high. 

6. As soon as the instrument with status bit 6 high is found check the 
rest of the status bits to determine what is required. 

The SPOLL(707) command causes much more to happen on the bus 
than simply reading the register. This command clears the bus 
automatically, addresses the talker and listener, sends SPE (serial poll 
enable) and SPD (serial poll disable) bus commands, and reads the 
data. For more information about serial poll, refer to your controller 
manual, and programming language reference manuals. 

After the serial poll is completed, the RQS bit in the HP 16500A Status 
Byte Register will be reset if it was set. Once a bit in the Status Byte 
Register is set, it will remain set until the status is cleared with a *CLS 
command, or the instrument is reset. 



HP 16500A/16501A 
Programming Reference 



Status Reporting 
B-7 



Parallel Poll Parallel poll is a controller initiated operation which is used to obtain 

information from several devices simultaneously. When a controller 
initiates a Parallel Poll, each device returns a Status Bit via one of the 
DIO data lines. Device DIO assignments are made by the controller 
using the PPC (Parallel Poll Configure) sequence. Devices respond 
either individually, each on a separate DIO line; collectively on a single 
DIO line; or any combination of these two ways. When responding 
collectively, the result is a logical AND (True High) or logical OR 
(True Low) of the groups of status bits. 

Figure B-3 shows the Parallel Poll Data Structure. The summary bit is 
sent in response to a Parallel Poll. This summary bit is the "ist" 
(individual status) local message. 

The Parallel Poll Enable Register determines which events are 
summarized in the ist. The *PRE command is used to write to the 
enable register and the *PRE? query is used to read the register. The 
*IST? query can be used to read the "ist" without doing a parallel poll. 
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DEVICE DEFINED 
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Figure B-3. Parallel Poll Data Structure 
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Polling HP-IB Parallel Poll is the fastest means of gathering device status when 
DGViCeS several devices are connected to the bus. Each device (with this 

capability) can be programmed to respond with one bit of status when 
parallel polled. This makes it possible to obtain the status of several 
devices in one operation. If a device responds affirmatively to a 
parallel poll, more information about its specific status can be obtained 
by conducting a serial poll of the device. 



Configuring Certain devices, including the HP 16500A, can be remotely 
Parallel Poll programmed by a controller to respond to a parallel poll. A device 
Responses wn i° n k currently configured for a parallel poll responds to the poll by 
placing its current status on one of the bus data lines. The response 
and the data-bit number can then be programmed by the PPC (parallel 
Poll Configure) statement. No multiple listeners can be specified in 
this statement. If more than one device is to respond on a single bit, 
each device must be configured with a separate PPC statement. 

Example: ASSIGN ©Device TO 707 

PPOLL CONFIGURE @Device;Mask 

The value of Mask (any numeric expression can be specified) is first 
rounded and then used to configure the device's parallel response. The 
least significant 3 bits (bits 0 through 2) of the expression are used to 
determine which data line the device is to respond on (place its status 
on). Bit 3 specifies the "true" state of the parallel poll response bit of 
the device. A value of 0 implies that the device's response is 0 when its 
status bit message is true. 

Example: The following statement configures the device at address 07 on the 

interface select code 7 to respond by placing a 0 on bit 4 when its status 
response is "true." 

PPOLL CONFIGURE 707;4 
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Conducting a 
Parallel Poll 



The PPOLL (Parallel Poll) function returns a single byte containing up 
to 8 status bit messages for all devices on the bus capable of responding 
to the poll. Each bit returned by the function corresponds to the status 
bit of the device(s) configured to respond to the parallel poll (one or 
more devices can respond on a single line). The PPOLL function can 
only be executed by the controller. It is initiated by the simultaneous 
assertion of ATN and EOI. 



Example: Response = PPOLL(7) 



Disabling Parallel 
Poll Responses 



The PPU (Parallel Poll Unconfigure) statement gives the controller the 
capability of disabling the parallel poll responses of one or more 
devices on the bus. 



Examples: The following statement disables device 5 only: 

PPOLL UNCONFIGURE 705 

This statement disables all devices on interface select code 8 from 
responding to a parallel poll: 

PPOLL UNCONFIGURE 8 

If no primary address is specified, all bus devices are disabled from 
responding to a parallel poll. If a primary address is specified, only the 
specified devices (which have the parallel poll configure capability) are 
disabled. 
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HP-IB Commands The following paragraphs describe actual HP-IB commands which can 

be used to perform the functions of the Basic commands shown in the 
previous examples. 

Parallel Poll Unconfigure Command. The parallel poll un configure 
command (PPU) resets all parallel poll devices to the idle state (unable 
to respond to a parallel poll). 

Parallel Poll Configure Command. The parallel poll configure 
command (PPC) causes the addressed listener to be configured 
according to the parallel poll enable secondary command PPE. 

Parallel Poll Enable Command. The parallel poll enable secondary 
command (PPE) configures the devices which have received the PPC 
command to respond to a parallel poll on a particular HP-IB DIO line 
with a particular level. 

Parallel Poll Disable Command. The parallel poll disable secondary 
command (PPD) disables the devices which have received the PPC 
command from responding to the parallel poll. 

Table EM. Parallel Poll Commands 



Command 


Mnemonic 


Decimal 
Code 


ASCII/ISO 
Character 


Parallel Poll Unconfigure 
(Multiline Command) 


PPU 


21 


NAK 


Parallel Poll Configure 
(Addressed Command) 


PPC 


05 


ENQ 


Parallel Poll Enable 
(Secondary Command) 


PPE 


96-111 


I-O 


Parallel Poll Disable 
(Secondary Command) 


PPD 


112 


P 
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Error Messages 



This section covers the error messages that relate to the HP 16500A 
mainframe and modules. 



Device 200 Label not found 

Dependent Errors ^ M „ 

201 Pattern string invalid 

202 Qualifier invalid 

203 Data not available 
300 RS-232C error 
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Command Errors -100 



Command error (unknown command) (generic error) 



-101 Invalid character received 

-110 Command header error 

-111 Header delimiter error 

-120 Numeric argument error 

-121 Wrong data type (numeric expected) 

-123 Numeric overflow 

-129 Missing numeric argument 

-130 Non numeric argument error (characterising, or block) 

-131 Wrong data type (character expected) 

-132 Wrong data type (string expected) 

-133 Wrong data type (block type #D required) 

-134 Data overflow (string or block too long) 

-139 Missing non numeric argument 

-142 Too many arguments 

-143 Argument delimiter error 

-144 Invalid message unit delimiter 



Error Messages 
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Execution Errors -200 



No Can Do (generic execution error) 



-201 Not executable in Local Mode 

-202 Settings lost due to return-to-local or power on 

-203 Trigger ignored 

-211 Legal command, but settings conflict 

-212 Argument out of range 

-221 Busy doing something else 

-222 Insufficient capability or configuration 

-232 Output buffer full or overflow 

-240 Mass Memory error (generic) 

-241 Mass storage device not present 

-242 No media 

-243 Bad media 

-244 Media full 

-245 Directory full 

-246 File name not found 

-247 Duplicate file name 

-248 Media protected 
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Internal Errors -300 Device Failure (generic hardware error) 



-301 Interrupt fault 
-302 System Error 
-303 Timeout 
-310 RAM error 

-311 RAM failure (hardware error) 
-312 RAM data loss (software error) 
-313 Calibration data loss 
-320 ROM error 
-321 ROM checksum 

-322 Hardware and Firmware incompatible 
-330 Power on test failed 
-340 Self Test failed 

-350 Too Many Errors (Error queue overflow) 
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Query Errors -400 Query Error (generic) 

-410 Query INTERRUPTED 
-420 Query UNTERMINATED 

-421 Query received. Indefinite block response in progress 
-422 Addressed to Talk, Nothing to Say 
-430 Query DEADLOCKED 
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Index 



*CLS command, 5-4 

*ESE command, 5-5 

*ESR command, 5-7 

*IDN command, 5-9 

*IST command, 5-10 

*OPC command, 5-12 

*OPT command, 5-13 

*PRE command, 5-14 

*RST command, 5-16 

*SRE command, 5-17 

*STB command, 5-19 

*TRG command, 5-21 

*TST command, 5-22 

*WAI command, 5-24 
32767, 4-6 
9.9E+37, 4-6 
:: = , 4-7 



Addressed talk/listen mode, 
Addressing the instrument 

HP-IB, 1-4 

RS_232C, 1-4 
Angular brackets, 1-3, 4-7 
AUToload command, 8-4 



2-2 



B 



Baud rate, 3-6 
BEEPer command, 
Binary, 1-10 
Bit definitions, B-3 
Braces, 4-7 



6-3 



Cable 

RS-232C, 3-2 
CAPability command, 6-4 
Card identification numbers, 6-5 
CARDcage command, 6-5 
CARD cage query, 1-15 
CATalog command, 8-5 
CESE command, 6-7 
CESR command, 6-9 
Character data, 1-10, 1-18 
Character program data, 1-10, 1-18 
Clear To Send (CTS), 3-5 
CME, B-3 
Command, 1-5, 1-17 

*CLS, 5-4 

*ESE, 5-5 

*OPC, 5-12 

*PRE, 5-14 

*RST, 5-16 

*SRE, 5-17 
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Command (continued) 

*TRG, 5-21 

*WAI, 5-24 

AUToload, 8-4 

BEEPer, 6-3 

CESE, 6-7 

COPY, 8-6 

DATA, 7-3 

DELete, 9-3 

DOWNload, 8-7 

DSP, 7-6 

EOI, 6-11 

HEADer, 1-17,7-8 

INITialize, 8-9 

INPort, 9-5 

INSert, 9-6 

LOAD:CONFig, 8-10 

LOADrlASSembler, 8-11 

Lockout, 3-8, 6-13 

LONGform, 1-17,7-9 

MENU, 6-14 

MESE, 6-16 

MSI, 8-12 

PACK, 8-13 

PRINt, 7-10 

PURGe, 8-14 

REName, 8-15 

RMODe, 6-20 

SELect, 1-13, 6-21 

SETColor, 6-23 

SETup, 7-11 

SKEW, 9-7 

STARt, 6-24 

STOP, 6-25 

STORe:CONFig, 8-16 

TREE, 9-8 
Command cross-reference, 4-12 
Command errors, C-2 
Command header, 1-5 
Command mode, 2-1 
Command set organization, 4-11 



Command structure, 1-14, 4-8 
Command tree, 4-2 - 4-3 

SELect, 6-22 
Command types, 4-2 
Commands 

Expansion frame, 4-8 

Mainframe, 4-8 
Common command header, 1-7 
Common commands, 4-2, 4-8, 5-1, A-27 
Compound command header, 1-6 
Compound header, 4-4 
Configuration file, 1-12, 1-15 
Controller mode, 2-2 

RS-232C, 3-6 
Controllers, 1-2 
COPY command, 8-6 

D 



Data bits, 3-6-3-7 

Data Carrier Detect (DCD), 3-5 

DATA command, 7-3 

Data Communications Equipment, 3-2 

Data mode, 2-1 

Data Set Ready (DSR), 3-5 

Data Terminal Equipment, 3-2 

Data Terminal Ready (DTR), 3-4 

DCE, 3-2 

DCL, 2-5 

DDE, B-3 

Decimal, 1-10 

Definite-length block response data, 1-20 
Definitions, 4-7 
DELete command, 9-3 
Device address 

HP-IB, 1-4,2-3 

RS-232C, 1-4,3-8 
Device clear, 2-5 
Device dependent errors, C-l 
DOWNload command, 8-7 
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DSP command, 7-6 
DTE, 3-2 

E 



Ellipsis, 4-7 

Enter statement, 1-2 

EOI, 1-10 

EOI command, 6-11 

ERRor command, 7-7 

Error messages, C-l 

ESB, B-3 

Event Status Register, B-3 
EXE, B-3 

Execution errors, C-3 
Expansion frame commands, 4-8 
Extended interface. 3-4 

F 



File types, 8-8 

G 



GET, 2-5 

Group execute trigger, 2-5 

H 



HEADer command, 1-17, 7-8 
Hexadecimal, 1-10 
HP-IB, l-4,2-l-2-2,A-i,B-6 
HP-IB address, 2-2 
HP-IB commands, B-12 
HP-IB device address, 2-3 



HP-IB interface, 2-2 
HP-IB interface code, 2-3 
HP-IB interface functions, 2-1 
HTIMe query, 9-4 

I 



IEEE 488.1, 2-l,3-l,A-l 
IEEE 488.1 bus commands, 2-5 
IEEE 4882, 3-1, A-l 
IFC, 2-5 
Infinity, 4-6 
Initialization, 1-12 
INITialize command, 8-9 
INPort command, 9-5 
Input buffer, A-2 
INSert command, 9-6 
Instrument address, 2-3 

HP-IB, 1-4 
Interface capabilities, 2-1 

RS-232C, 3-6 
Interface clear, 2-5 
Interface code 

HP-IB, 2-3 
Interface select code, 1-4 

HP-IB, 1-4 

RS-232C, 3-8 
INTermodule subsystem, 9-1 
Internal errors, C-4 
InternalO, 4-7 
Interaall, 4-7 

L 



LCL, B-4 

LER command, 6-12 
Linefeed, 4-7 

Listening syntax, A-8 
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LOADrCONFig command, 8-10 
LOAD:IASSembler command, 8-11 
Local, 2-4 
Local lockout, 2-4 
Lockout command, 3-8, 6-13 
Longform, 1-9 

LONGform command, 1-17, 7-9 
Lowercase, 1-9 

M 



Mainframe commands, 4-2, 4-8, 6-1 
Mass storage unit specifier, 4-7 
MAV, B-3 

MENU command, 6-14 
MESE command, 6-16 
MESR command, 6-18 
Message terminator, 1-3 
MMEMory subsystem, 8-1 
MSB, B-4 
MSI command, 8-12 
MSS, B-3 
msus, 4-7, 8-1 

Multiple data parameters, 1-9 
Multiple numeric variables, 1-21 
Multiple program commands, 1-11 
Multiple queries, 1-21 
Multiple subsystems, 1-11 

N 



NL, 1-10,4-7 
Notation conventions, 4-7 
Numeric base, 1-10, 1-18 
Numeric data, 1-10 
Numeric program data, 1-10 
Numeric variables, 1-20 



o 



Octal, 1-10 
OPC, B-4 

Operation Complete, B-4 

OR notation, 4-7 

OUTPUT command, 1-3 

Output queue, A-2 

Output statement, 1-2 

Overlapped command, 5-12, 5-24, 6-24 - 6-25 

Overlapped commands, 4-6 

P 



PACK command, 8-13 

Parallel poll, B-8 

Parallel poll commands, B-12 

Parity, 3-6 

Parse tree, A-7 

Parser, A-2 

PON, B-3 

PPC, B-12 

PPD, B-12 

PPE, B-12 

PPU, B-12 

PRINt command, 7-10 

Printer, 4-9 

Printer mode, 2-2 

RS-232C, 3-6 
Program command, 1-5 
Program data, 1-9, A- 14 
Program examples, 4-9 
Program message, 1-5, A-9 
Program message syntax, 1-5 
Program message terminator, 1-10 
Program message unit, 1-5 
Program query, 1-5 
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Program syntax, 1-5 
Programming examples, 1-1 
Protocol, 3-6, A-3 

None, 3-6 

XON/XOFF, 3-7 
Protocol exceptions, A-4 
Protocols, A-2 
PURGe command, 8-14 



Query, 1-5, 1-8, 1-17 
*ESE, 5-5 
*ESR, 5-7 
*IDN, 5-9 
•1ST, 5-10 
*OPC, 5-12 
•OPT, 5-13 
•PRE, 5-14 
•SRE, 5-17 
•STB, 5-19 
•TST, 5-22 
AUToload, 8-4 
BEEPer, 6-3 
CAPability, 6-4 
CARDcage, 1-15, 6-5 
CATalog, 8-5 
CESE, 6-7 
CESR, 6-9 
DATA, 7-3 
EOI, 6-11 
ERRor, 7-7 
FTIMe, 9-4 
HEADer, 7-8 
INPort, 9-5 
LER, 6-12 
LOCKout, 6-13 
LONGform, 7-9 
MENU, 6-15 
MESE, 6-16 



Query (continued) 
MESR, 6-18 
MSI, 8-12 
PRINt, 7-10 
RMODe, 6-20 
SELect, 6-21 
SETColor, 6-23 
SETup, 7-11 
SKEW, 9-7 
TREE, 9-8 
TTTMe, 9-10 
UPLoad, 8-17 
Query command, 1-8 
Query errors, C-5 
Query response, 1-16 
Query responses, 4-6 
Question mark, 1-8 
QYE, B-4 

R 



Receive Data (RD), 3-3 - 3-4 
Remote, 2-4 
Remote enable, 2-4 
REN, 2-4 

REName command, 8-15 
Request To Send (RTS), 3-4 
Response data, 1-20 
Response message, A-21 
RMODe command, 6-20 
Root, 4-2,4-4,4-9 
RQC, B-4 
RQS, B-3 

RS-232C, 1-4, 3-1, 3-8, A-l 
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s 



SDC, 2-5 

SELect command, 1-13, 6-21 
Select command tree, 6-22 
Selected device clear, 2-5 
Selecting a module, 1-13 
Separator, 1-5, A-18 
Sequential commands, 4-6 
Serial poll, B-6 

Service Request Enable Register, B-3 

SETColor command, 6-23 

SETup command, 7-11 

Shortform, 1-9 

Simple command header, 1-5 

SKEW command, 9-7 

sp, 4-7 

Square brackets, 4-7 

STARt command, 6-24 

Status, 1-21, 5-2, B-l 

Status byte, B-4 

Status registers, 1-21 

Status reporting, B-l 

Stop bits, 3-6 

STOP command, 6-25 

STQRe:CONFig command, 8-16 

String variables, 1-19 

Subsystem 

INTermodule, 9-1 

MMEMory, 8-1 

SYSTem, 7-1 
Subsystem commands, 4-2, 4-9 
Suffix multiplier, A- 16 
Suffix units, A- 16 
Syntax, A-8 
Syntax diagram, 4-8 

Common commands, 5-3 

IEEE 488.2, A-5 

INTermodule subsystem, 9-1 - 9-2 



Syntax diagram (continued) 

Mainframe commands, 6-1 - 6-2 
MMEMory subsystem, 8-1 - 8-3 
SYSTem subsystem, 7-1 - 7-2 

SYSTem subsystem, 7-1 

T 



Talk only mode, 2-2 
Talking syntax, A-21 
Talking to the Instrument, 1-2 

HP 16500A, 1-2 

HP16501A, 1-2 
Terminator, 1-3, 1-10, A-26 
Three-wire Interface, 3-3 
Trailing dots, 4-7 
Transmit Data (TD), 3-3 - 3-4 
TREE command, 9-8 
Tree traversal rules, 4-4 
Truncation rule, 4-1 
TTIMe query, 9-10 

u 



UPLoad command, 8-17 
Uppercase, 1-9 
URQ, B-3 

w 



White space, 4-7 

X 



XXX, 1-12,1-14,1-19,4-4,4-7 
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